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时 我 有 写 博客 的 习惯 ， 喜 欢 将 学 到 的 知识 点 放 在 博客 上 : 一 是 当 作 自 己 的 学 习 笔 记 , 将 学 习 
的 内 容 整 理 之 后 再 输出 ,也 能 够 加 深 印 象 ， 忘记 知识 点 时 还 可 以 快速 复习 ; 二 是 分 享 给 有 需要 的 朋 
A. 希望 各 位 在 学 习 时 能 少 走 些 弯路 , 少 跳 些 坑 。 作 为 经 常 从 网 上 索取 免费 资料 的 一 员 ， 我 也 要 有 
回报 的 思想 。 

SSM 框架 集 目前 是 J2EE 开发 最 常用 、 最 流行 的 框架 。Spring Boot 是 由 Pivotal 团队 提供 的 全 
新 框架 ,设计 目的 是 简化 新 Spring 应 用 的 初始 搭建 以 及 开发 过 程 。Docker 容器 技术 在 现在 流行 的 
Devops 流水 线 上 也 扮演 着 重要 的 角色 。 

在 本 书 中 ， 我 们 将 对 Spring, Spring MVC、MyBatis、Spring Boot, Docker 的 使 用 进行 介绍 ， 
而 且 每 个 章节 基本 都 有 代码 示例 ， 基 本 都 是 与 技术 相关 、 业 务 相关 的 ， 例 子 接近 生活 ， 便 于 读者 对 
每 个 章节 的 知识 点 加 深 理解 ， 快 速 上 手 。 


本 书 读者 对 象 


e 热 入 面向 对 象 编程 、 经 验 丰 富 又 打算 学 习 SSM, Spring Boot 的 其 他 语言 从 业者 。 
e 有 意 提升 网 站 和 Web 应 用 程序 开发 能 力 的 Web 开发 人 员 。 
e 希望 在 学 习 完 Java 编程 想 进 一 步 提 高 开发 技能 的 初学 者 。 


阅读 本 书 需 要 掌握 Java 面向 对 象 编程 知识 ， 了 解 面向 对 象 思想 。 
本 书 内 容 


本 书 共 包 括 11 章 。 第 1 章 介 绍 Java 基础 ， 主 要 介绍 Spring 框架 中 常用 的 反射 和 注解 技术 ， 了 
解 反射 、 注 解 相关 概念 。 第 2 章 先 对 Spring 框架 进行 简单 介绍 ,讲解 Spring 框架 重要 的 IOC、AOP 
思想 。 第 3 章 讲 解 Spring 核心 容器 ， 介 绍 Bean 的 配置 、 注 入 方式 、 作 用 域 和 生命 周期 。 第 4 章 对 
AOP 进行 详细 介绍 ， 了 解 AspectJ 的 使 用 。 第 5 章 介 绍 Spring 的 DAO 模块 ， 同 时 了 解 JDBC 的 使 
用 。 第 6 章 学 习 MyBatis 的 使 用 , 主要 包括 XML 的 配置 和 映射 , 动态 SQL、 逆 向 工程 和 Pagehelper 
的 使 用 。 第 7 章 介 绍 SSM 框架 中 的 SpringMVC, 了 解 Spring MVC 的 处 理 流程 、View 与 Controller 
之 间 的 数据 传递 ,第 8、9 章 主 要 介绍 Spring Boot 的 相关 知识 以 及 Spring Boot 配置 ,使 用 Spring Boot 
引入 Thymeleaf、JSP、MyBatis、Redis、Druid 等 工具 。 第 10 章 讲述 Docker 基础 知识 以 及 Docker 
的 三 大 核心 概念 ， 并 在 Docker 中 使 用 Tomcat 部 署 war 包 。 第 11 章 给 出 了 一 个 项 目 实例 ， 对 前 面 
章节 介绍 的 知识 点 进行 巩固 。 


本 书 导读 
学 习 编程 步 又 可 以 用 “学 、 练 、 悟 、 通 ”4 个 字 概括 。 


(1) “学 ” 指 的 是 接收 的 过 程 ， 侧 重 理论 。 本 书 每 个 章节 基本 都 是 先 介绍 理论 知识 ， 让 读者 
理解 知识 点 为 什么 出 现 、 要 解决 什么 问题 、 有 哪些 优势 。 

D “ 练 ” 指 的 是 实践 的 过 程 。 没 有 实践 只 有 理论 属于 纸上谈兵 ， 看 的 时 候 理解 ， 操 作 时 无 
从 下 手 ， 动 手 能 力 差 。 本 书 每 个 章节 都 有 实例 ， 在 学 习 理 论 的 过 程 中 可 以 参考 实例 操作 一 遍 。 

G) “ 悟 ” 指 的 是 思考 的 过 程 。 练 更 多 的 是 模仿 ， 照 葫芦 画 球 。 在 练 的 过 程 中 也 要 多 思考 ， 
多 问 几 个 为 什么 ， 多 归纳 总 结 ， 在 做 项 目 之 前 可 以 先 把 整个 思路 在 脑子 里 过 一 遍 。 

(4) “ 通 ” 指 的 是 举一反三 的 过 程 。 实 现 本 书 的 例子 不 难 ， 难 的 是 将 学 到 的 知识 举一反三 ， 
灵活 地 运用 到 其 他 项 目 中 。 可 以 找 一 些 开源 项 目 来 研究 ， 以 达到 融会 贯通 的 境界 。 


示例 源码 下 载 


本 书 基本 每 个 章节 都 有 示例 ， 完 整 源码 可 以 扫描 右边 二 维 码 ， 如 果 
下 载 有 问题 ， 请 联系 技术 支持 邮箱 cuiyw525@163.com， 邮 件 主 题 为 
“Spring 快速 入 门 ”。 要 运行 本 书 中 的 示例 ， 需 要 安装 Eclipse, Maven, 
并 配置 相关 环境 。 


勘误 与 技术 支持 邮箱 


作者 已 尽 最 大 努力 确保 正文 和 代码 没有 问题 。 可 是 ， 金 无 足 赤 ， 朴 漏 在 所 难免 。 如 果 书 中 
有 错误 ， 和 希望 您 能 及 时 反馈 给 我 们 。 我 们 将 诚挚 接受 广大 读者 的 批评 指正 ， 交 流 邮 箱 为 
cuiyw525@163.com。 勘 误 将 发 布 在 作者 博客 上 : https://www.cnblogs.com/Sishare/. 
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在 学 习 Spring 之 前 我 们 需要 对 Java 基础 语法 有 一 定 的 了 解 , Java 中 最 重要 的 两 个 知识 点 是 注 
解 和 反射 .注解 和 反射 在 Spring 框架 中 应 用 的 最 广泛 .掌握 注解 和 反射 ,有 助 于 后 面 Spring 的 学 
3j. 


本 章 主要 涉及 的 知识 点 : 

e 注解 基础 : 什么 是 注解 ?怎么 理解 注解 ?什么 是 元 注解 ? 
e ”注解 应 用 : 自 定义 注解 、 注 解 的 应 用 场景 。 

* 反射 : 反射 的 定义 、 反 射 的 应 用 。 


不 管 学 习 什么 框架 都 需要 先 把 Java 基础 夯实 ， 基 础 打 好 之 后 才能 厚积薄发 。 用 到 的 时 候 | 


不 能 只 会 用 ， 不 知道 为 什么 这 样 用 。 学 习 编 程 还 有 最 重要 的 一 点 就 是 需要 勤 动手 ， 不 能 眼 
高 手 低 ， 看 着 会 做 ， 真 要 动手 时 无 从 下 手 。 


1.1 注解 


本 节 首 先 介绍 注解 的 基本 概念 ， 理 解 什么 是 注解 、 注 解 的 作用 是 什么 。 在 此 基础 上 通过 示 
例 动 手 操作 加 深 理解 。 


1.1.1 什么 是 注解 


我 们 先 看 官方 解释 : 它 提供 了 一 种 安全 的 类 似 注释 的 机 制 ， 用 来 将 任何 的 信息 或 元 数据 
(metadata) 与 程序 元 素 〈 类 、 方 法 、 成 员 变量 等 ) 进行 关联 。 为 程序 的 元 素 〈 类 、 方 法 、 成 
员 变 量 ) 加 上 更 直观 、 更 明了 的 说 明 , 这 些 说 明 信 息 与 程序 的 业务 逻辑 无 关 ， 并 且 供 指定 的 工 
具 或 框架 使 用 。Annontation 像 一 种 修饰 符 一 样 ， 应 用 于 包 、 类 型 、 构 造 方法 、 方 法 、 成 员 变 
量 、 参 数 及 本 地 变量 的 声明 语句 中 。Java 注解 是 附加 在 代码 中 的 一 些 元 信息 ， 便 于 一 些 工具 
在 编译 、 运 行 时 进行 解析 和 使 用 ,起 到 说 明 、 配 置 的 功能 。 注解 不 会 也 不 能 影响 代码 的 实际 逻 
辑 ， 仅 仅 起 到 辅助 性 的 作用 ， 包 含 在 java.lang.annotation 包 中 。 

看 着 上 面 的 解释 是 不 是 还 是 一 头 雾 水 ? 其 实 我 们 可 以 更 通俗 地 理解 一 下 。 最 近 几 年 出 现 一 
个 词 “ 斜 杠 青年 ”， 还 有 黄 某 某 拍摄 的 广告 语 : 给 人 贴标签 、 下 定义 ， 总 是 很 容易 ， 而 我 却 不 
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会 因为 一 件 事 被 定性 。 这 里 的 斜 杠 青年 、 贴 标签 都 是 把 某 些 属性 附加 给 对 象 ， 和 注解 功能 差 不 
多 ， 它 提供 了 一 种 安全 的 类 似 注释 的 机 制 ， 用 来 将 任何 信息 或 元 数据 (metadata) 与 程序 元 素 


〈 类 、 方 法 、 成 员 变量 等 ) 进行 关联 。 我 们 可 以 再 来 理解 一 下 这 句 话 ， 这 里 的 程序 元 素 可 以 理 


解 为 人 ， 信 息 或 元 数据 理解 为 标签 ， 把 标签 属性 〈 信 息 或 元 数据 ) 赋 给 人 【程序 元 素 ) 。 
上 面 两 段 基 本 把 什么 注解 解释 出 来 了 ， 如 果 还 是 不 知道 注解 是 什么 ， 那 也 没关系 。 其 实 我 
们 在 编程 中 已 经 用 到 或 者 看 到 过 了 ， 比 如 @Override、@Deprecated。 是 不 是 很 熟悉 ? 其 实 它们 
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内 置 注解 


上 面 的 @Override、@Deprecated 都 是 Java 中 内 置 的 注解 ， 除 了 这 两 个 还 有 其 他 的 内 置 注 
解 。 这 里 列举 了 几 个 常用 的 内 置 注解 以 及 它们 的 作用 。 
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@Deprecated: *mit & 4 2H iF MF PIS S EA IEATN A AUDACES RS, SHRTRAEA 
调用 一 个 过 时 的 元 素 ， 比 如 过 时 的 方法 、 过 时 的 类 、 过 时 的 成 员 变 量 。 

@Override: 提示 子 类 要 复写 父 类 中 被 @Override 修饰 的 方法 。 

@SuppressWarnings: 阻止 警告 的 意思 。 调 用 被 @Deprecated 注解 的 方法 后 ， 编 译 器 会 
警告 提醒 ， 而 有 时 候 开发 者 会 忽略 这 种 警告 ， 他 们 可 以 在 调用 的 地 方 通过 
@SuppressWarnings: 达到 目的 。 

@SafeVarargs: 参数 安全 类 型 注解 。 它 的 目的 是 提醒 开发 者 不 要 用 参数 做 一 些 不 安全 
的 操作 ， 它 的 存在 会 阻止 编译 器 产生 unchecked 这 样 的 警告 。 它 是 在 Java 1.7 的 版 本 
中 加 入 的 。 

@Functionallnterface: 函数 式 接口 注解 ， 这 个 是 Java 1.8 版 本 引入 的 新 特性 。 函 数 式 
编程 很 火 ， 所 以 Java 8 也 及 时 添加 了 这 个 特性 。 函 数 式 接口 (Functional Interface) 就 
是 一 个 具有 一 个 方法 的 普通 接口 。 


元 注解 


通过 前 面 的 两 小 节 ， 我 们 应 该 对 注解 有 了 一 定 的 认识 ， 下 面 进一步 地 了 解 一 下 注解 。 我 们 
在 自 定 义 注 解 时 会 出 现 图 1-1 所 示 的 一 些 选项 。 


Name: | 


Modifiers: @public ^ Opackage ^ private protected 


回 Add @Retention: C, Source @Class O Runtime 

[add GTarget Type DFeld Method 
口 parameter 口 constuctor [Local variable 
口 Annotation type [Package Type parameter 


Type use 


[Add @Documented 


Do you want to add comments? (Configure templates and default value here) 
口 Generate comments 


3X HATHA @Retention, @Target. @Documented 其 实 就 是 元 注解 。 在 创建 时 配置 这 些 元 注 
解 , 我 们 也 可 以 推断 出 元 注解 的 作用 是 什么 。 元 注解 负责 注解 自 定义 注解 。java.lang.annotation 
提供 了 5 种 元 注解 ， 专 门 注解 其 他 的 注解 : 
* @Retention: 什么 时 候 使 用 该 注解 。 
© @Target: 注解 用 于 什么 地 方 。 
*  (üDocumented: 注解 是 否 将 包含 在 JavaDoc 中 。 
* @Inherited: 是 否 允 许 子 类 继承 该 注解 。 
* @Repeatable: 指定 注解 可 重复 使 用 。 
1. @Retention 定义 注解 的 生命 周期 
©  RetentionPolicy.SOURCE: 在 编译 阶段 丢弃 。 这 些 注 解 在 编译 结束 之 后 不 再 有 任何 意义 ， 
所 以 它们 不 会 写 入 字 节 码 。@Override 和 @SuppressWarnings 都 属于 这 类 注解 。 
* RetentionPolicy.CLASS: 在 类 加 载 的 时 候 丢 弃 。 在 字 节 码 文 件 的 处 理 中 有 用 。 注 解 默 认 使 
用 这 种 方式 。 
*  RetentionPolicy. RUNTIME: 始终 不 会 丢 齐 ， 运 行 期 也 保留 该 注解 ， 因 此 可 以 使 用 反射 机 
制 读 取 该 注解 的 信息 。 我 们 自 定义 的 注解 通常 使 用 这 种 方式 。 
2. @Target 表示 注解 用 于 什么 地 方 
默认 值 为 任何 元 素 ， 表 示 该 注解 用 于 什么 地 方 。 可 用 的 ElementType 参数 包括 : 
ElementType.CONSTRUCTOR: 用 于 描述 构造 器 。 
ElementType.FIELD: 成 员 变 量 、 对 象 、 属 性 〈 包 括 enum 实例 ) o 
ElementType.LOCAL VARIABLE: 用 于 描述 局 部 变量 。 
ElementType.METHOD: 用 于 描述 方法 。 
ElementType.PACKAGE: 用 于 描述 包 。 
ElementType.PARAMETER: 用 于 描述 参数 。 
ElementType.TYPE: 用 于 描述 类 、 接 口 〈 包 括 注解 类 型 ) 或 enum 声明。 
3. @Documented 是 一 个 简单 的 Annotations 标记 注解 
表示 是 否 将 注解 信息 添加 在 Java 文档 中 。 
4. @Inherited 定义 注解 和 子 类 的 关系 
@Inherited 元 注解 是 一 个 标记 注解 ,阐述 了 某 个 被 标注 的 类 型 是 被 继承 的 。 如 果 一 个 使 用 
了 @Inherited 修饰 的 annotation 类 型 被 用 于 一 个 class， 那 么 这 个 annotation 将 被 用 于 该 class 
的 子 类 。 


5. @Repeatable 指定 注解 可 重复 使 用 
使 用 @Repeatable 修饰 表示 该 注解 可 以 为 重复 使 用 。 
1.1.4 自 定义 注解 


元 注解 是 负责 注解 自 定义 注解 的 。 自 定义 注解 时 是 有 一 些 规则 限制 的 ， 具 体 如 下 : 
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e Annotation 型 定义 为 @interface, 所 有 的 Annotation 会 自动 继承 java.lang.Annotation 这 一 接 
口 ， 并 且 不 能 再 去 继承 别 的 类 或 是 接口 。 

© 参数 成 员 只 能 用 public 或 默认 (default) 这 两 个 访问 权 修饰 。 

© “参数 成 员 只 能 用 基本 类 型 byte、short、char、int、long、float、double、boolean 八 种 基本 
数据 类 型 和 String, Enum, Class, annotations 等 数据 类 型 ， 以 及 这 一 些 类 型 的 数组 。 

。 要 获取 类 方法 和 字段 的 注解 信息 ， 必 须 通 过 Java 的 反射 技术 来 获取 Annotation 对 象 ， 
为 除 此 之 外 没有 其 他 获取 注解 对 象 的 方法 。 

e ”注解 也 可 以 没有 定义 成 员 。 


我 们 这 里 自 定义 一 个 注解 来 练习 一 下 ， 主 要 用 来 演示 自 定义 注解 以 及 注解 的 继承 。 
1. 定义 CustomDescription 注解 


CustomDescription 注解 相当 于 标签 。 为 了 能 多 贴标签 ， 又 定义 了 注解 容器 
CustomDescriptions 。 其 中 ，@Retention(RUNTIME) 表 示 在 运行 时 环境 也 可 以 获取 注解 ， 
@Inherited 表示 可 继承 ，@Repeatable(CustomDescriptions.class) 表 示 该 注解 可 多 次 使 用 。 


package CusAnnontation; 


import static java.lang.annotation.ElementType. TYPE; 
import static java.lang.annotation.RetentionPolicy. RUNTIME; 
import java.lang.annotation. Documented; 

import java.lang.annotation. Inherited; 

import java.lang.annotation.Retention; 

import java.lang.annotation.Target; 

import java.lang.annotation.Repeatable; 


@Documented 

@Retention (RUNTIME) 

@Target (TYPE) 

@Inherited 

@Repeatable (CustomDescriptions.class) 

public @interface CustomDescription { 
String description() default ""; 

} 


CustomDescriptions 容器 : 


package CusAnnontation; 


import static java.lang.annotation.ElementType. TYPE; 
import static java.lang.annotation.RetentionPolicy. RUNTIME; 
import java.lang.annotation.Documented; 

import java.lang.annotation. Inherited; 

import java.lang.annotation.Retention; 

import java.lang.annotation.Target; 
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@Documented 

@Retention (RUNTIME) 

@Target (TYPE) 

@Inherited 

public @interface CustomDescriptions { 
CustomDescription[] value(); 

} 


2. 实现 继承 关系 


这 里 为 了 演示 ， 我 们 创建 了 两 个 类 : 一 个 基 类 Person， 一 个 子 类 Student。 在 Person 类 加 
两 个 自 定义 注解 ， 在 Student 中 加 一 个 自 定义 注解 。 


Person: 
package CusAnnontation; 
@CustomDescription (description=" 基 类 ") 


GCustomDescription (description=" 人 ") 
Public class Person { 


Private String Name; 


Public String getName() { 
return Name; 


Public void setName (String name) { 
Name = name; 


} 
Student: 

package CusAnnontation; 
@CustomDescription (description-" ^E") 


public class Student extends Person ( 
private String StudentId; 


public String getStudentId() ( 


return StudentId; 


public void setStudentId(String studentId) { 
StudentId = studentId; 
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3. 通过 反射 获取 注解 属性 值 


public static void main(String[] args) { 
// TODO Auto-generated method stub 
CustomDescriptions customDescriptions =new Student ().getClass(). 
getAnnotation (CustomDescriptions.class) ; 
for (CustomDescription h: customDescriptions.value()) { 
System.out.println("description:" + h.description()); 
H 
$ 


这 里 我 们 想 通 过 反射 〈 可 以 先 不 要 理解 ) 获取 Student 类 的 注解 值 ， 那 么 问题 来 了 ， 它 是 
输出 什么 的 呢 ? 会 输出 “description: 学 生 ” 吗 ? 并 不 是 ， 而 是 输出 父 类 Person 的 注解 。 


输出 : 
description: 基 类 
description: 人 
如 果 想 输出 子 类 Student 的 注解 该 怎么 设置 呢 ?很 简单 ， 只 需 在 子 类 Student LAHK 
注解 就 好 。 
@CustomDescription (description=" 学 生 ") 


@CustomDescription (description="A") 
public class Student extends Person 


输出 : 
description: 学 生 
description: 人 
此 时 输出 的 就 是 子 类 的 注解 值 了 。 这 里 我 们 还 可 以 验证 @Retention 生命 周期 的 作用 ， 只 
需要 把 @Retention(RUNTIME) 改 成 CLASS ， 再 运行 就 会 报错 ， 因 为 main 方法 中 的 
custormDescriptions 对 象 是 一 个 null 空 值 。 不 过 自 定 义 注 解 一 般 来 说 都 是 使 用 
@Retention(RUNTIME). 


1.1.5 注解 使 用 场景 介绍 


在 上 一 小 节 通 过 实例 学 习 了 自 定义 注解 的 使 用 , 之 后 就 该 解决 怎么 用 的 问题 了 。 其 实 , 注 
解 应 用 的 场景 还 是 挺 多 的 。 


(1) 使 用 注解 做 bean 的 属性 值 校 验 ， 例 如 在 开发 Java 服务 器 端 代码 时 ， 会 要 求 对 外 部 
传 来 的 参数 合法 性 进行 验证 。hibernate-validator 提供 了 一 些 常用 的 参数 校 验 注解 。 

(2) 使 用 注解 做 权限 控制 。 例 如 ，shiro 框架 中 有 5 个 权限 注解 ， 我 们 也 可 以 自 定义 注解 
进行 权限 控制 。 

(3) 代替 配置 文件 功能 ， 像 Spring 基于 注解 的 配置 ， 减 少 了 xml 的 配置 。 

(4) 可 以 生成 文档 ， 像 Java 代码 注释 中 的 @see、@param 等 。 


这 里 只 是 列举 了 几 个 使 用 场景 ， 其 实 还 有 很 多 地 方 可 以 使 用 注解 。 


1.2 反射 


本 节 首 先 介绍 反射 的 基本 概念 ， 理 解 什么 是 反射 ， 以 及 Class 类 和 反射 常用 API， 通 过 实 
例 操 作 来 学 习 反 射 的 使 用 。 


1.2.1 反射 机 制 


在 上 面 自 定义 注解 时 我 们 也 有 提 到 反射 , 要 获取 类 方法 和 字段 的 注解 信息 ,必须 通过 Java 
的 反射 技术 来 获取 Annotation 对 象 。 那 么 什么 是 反射 呢 ? 在 运行 状态 中 ， 对 于 任意 一 个 类 ， 
都 能 够 知道 这 个 类 的 所 有 属性 和 方法 ; 对 于 任意 一 个 对 象 , 都 能 够 调用 它 的 任意 一 个 方法 和 属 
性 ， 这 种 动态 获取 的 信息 以 及 动态 调用 对 象 的 方法 的 功能 称 为 Java 语言 的 反射 机 制 。 它 有 点 
类 似 照妖镜 的 作用 ,不 管 是 什么 妖魔 鬼怪 (类 或 对 象 ) 都 能 看 到 它 的 真面目 (获取 类 的 属性 方 
法 、 调 用 对 象 的 属性 方法 ) 。 


1.2.2 理解 Class 类 


反射 机 制 可 以 动态 获取 类 信息 以 及 调用 对 象 方法 , 那 它 是 通过 什么 实现 的 呢 ? 这 就 要 介绍 
一 下 Class 类 了 。 首 先 明确 Class 也 是 一 个 类 ， 只 是 它 是 一 个 描述 类 的 类 ， 也 可 以 生成 对 象 。 
对 于 每 个 类 而 言 ， 在 IRE 中 有 且 仅 有 一 个 不 变 的 Class 类 型 的 对 象 ， 而 这 个 Class 类 型 的 对 
象 只 能 由 系统 建立 ， 封装 了 当前 对 象 所 对 应 的 类 的 信息 ， 有 哪些 属性 、 方 法 、 构 造 嚣 以 及 实现 
了 哪些 接口 等 。 每 个 类 的 实例 都 会 记得 自己 是 由 哪个 Class 实例 所 生成 的 。 

要 获取 类 信息 或 调用 对 象 方 法 ， 肯定 首先 要 获取 到 该 类 或 对 象 对 应 的 Class 类 的 实例 。 一 
般 获 取 Class 对 象 有 3 种 方式 。 


© 通过 类 名 获取 ， 类 名 .class。 
© 通过 对 象 获取 ， 对 象 .getClass()。 
e 通过 全 类 名 获取 ，Class.forName (全 类 名 ) 。 


这 里 我 们 可 以 使 用 字符 串 来 做 验证 。 


public static void main(String[] args) throws ClassNotFoundException { 
// 字 符 串 的 例子 
Class clazz = null; 
// 类 名 .class 
clazz = String.class; 
System. out.println(clazz); 
/ 518 .getClass () 
clazz = "ReflectionTest".getClass(); 
System.out.println(clazz); 
//Class.forName (全 类 名 ) 
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clazz = Class.forName("java.lang.String"); 
System.out.println(clazz); 


class java.lang.String 
class java.lang.String 
class java.lang.String 


通过 3 种 方式 获取 到 Class 实例 后 ， 再 了 解 一 下 Class 类 常用 的 方法 〈 见 表 1-1) o 
表 1-1 Class 类 常用 的 方法 


功能 说 明 


forName(String name) 返回 指定 类 名 name 的 Class 对 象 


newInstance() 调用 默认 构造 函数 ， 返 回 该 Class 对 象 的 一 个 实例 
返回 此 Class 对 象 所 表示 的 实体 (类 、 接口 、 数 组 类 、 基 本 类 型 或 void) 
名 称 
getSuperClass() 返回 当前 Class 对 象 的 父 类 的 Class 对 象 
获取 当前 Class 对 象 的 接口 


Pore 
getFields() 获取 类 中 public 类 型 的 属性 
getField(String name) 获取 类 特定 的 方法 ，name 参数 指定 了 属性 的 名 称 


peiDeclaredFields0 获取 类 中 所 有 的 属性 Cpublic, protected, default, private) ， 但 不 包括 
继承 的 属性 


获取 类 特定 的 方法 ，name 参数 指定 了 属性 的 名 称 


getConstructors() 获取 类 中 的 公共 方法 

getConstructor(Class[] params) 获取 类 的 特定 构造 方法 ，params 参数 指定 构造 方法 的 参数 类 型 
getDeclaredConstructors() 获取 类 中 所 有 的 构造 方法 (public、protected、default、private) 
getDeclaredConstructor(Class[] params) | 获取 类 的 特定 构造 方法 ，params 参数 指定 构造 方法 的 参数 类 型 
getMethods() 获得 类 的 public 类 型 的 方法 

获得 类 的 特定 方法 ，name 参数 指定 方法 的 名 字 ，params 参数 指定 方法 
的 参数 类 型 

getDeclaredMethods() 获取 类 中 所 有 的 方法 (public. protected. default, private) 
getDeclaredMethod(String name, 获得 类 的 特定 方法 ，name 参数 指定 方法 的 名 字 ，params 参数 指定 方法 
Class[] params) 的 参数 类 型 


getName() 


getMethod(String name, Class[] params) 
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1.23 反射 的 使 用 


这 里 要 着 重 介绍 一 下 上 面 API 的 使 用 ， 因 为 在 后 面 要 学 习 的 Spring 中 IOC 的 原理 就 是 反 
射 加 工厂 模式 。 学 好 反射 API 有 助 于 理解 Spring 框架 内 部 实现 。 为 了 演示 Class 方法 的 使 用 ， 
在 注解 demo 的 基础 上 对 Person、Student 类 进行 了 修改 。 


Person 类 : 


Package Reflection; 


@CustomDescription (description=" 基 类 ") 


@CustomDescription (description= 
Public class Person { 


Private String Name; 


Public String getName() { 
return Name; 


Public void setName (String name) { 
Name = name; 


public String PersonPublicMethod(String str) 


{ 
return str; 


public Person(String name) { 
Name = name; 


public String PersonPrivateMethod(String str) 


{ 
return str; 


public Person() { 
super () ; 


$ 
Student 类 : 


Package Reflection; 
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@CustomDescription (description=" 学 生 ") 
GCustomDescription (description=" 人 ") 
Public class Student extends Person { 


public String StudentId; 


public String getStudentId() { 
return StudentId; 
) 


public void setStudentId(String studentId) { 
StudentId - studentId; 
H 


public String StudentPublicMethod(String str) 
{ 

return str; 
H 


private String StudentPrivateMethod(String str) 
{ 
return str; 


public Student (String name, String studentId) { 
super (name) ; 
StudentId = studentId; 


private Student (String name) { 
super (name) ; 
StudentId="123456"; 


public Student() { 


1. 描述 方法 Method 


描述 方法 主要 是 4 个 获取 方法 CgetMethods. getMethod. getDeclaredMethods 、 
getDeclaredMethod) 和 1 个 调用 方法 (invoke) 。 


getMethods: 获取 clazz 对 应 类 中 的 所 有 方法 ， 不 能 获取 private 方法 ， 且 获取 从 父 类 继承 
来 的 所 有 方法 ， 包 括 私 有 父 类 的 私有 方法 。 

getMethod: 获取 clazz 对 应 类 中 指定 方法 名 和 参数 类 型 的 方法 ， 不 能 获取 private 方法 ， 
且 获 取 从 父 类 继承 来 的 所 有 方法 ,包括 私有 父 类 的 私有 方法 。 因 为 存在 同方 法 名 不 同 参数 
这 种 情况 ， 所 以 只 有 同时 指定 方法 名 和 参数 类 型 才能 唯一 确定 一 个 方法 。 


e  getDeclaredMethods: 获取 所 有 方法 ， 包 括 私有 方法 ， 所 有 声明 的 方法 ， 都 可 以 获取 到 ， 
且 只 获取 当前 类 的 方法 。 

e ”getDeclaredMethod: 获取 clazz 对 应 类 中 指定 方法 名 和 参数 类 型 的 方法 ， 包 括 私有 方法 ， 
所 有 声明 的 方法 ， 都 可 以 获取 到 ， 且 只 获取 当前 类 的 方法 。 

© invoke: 执行 方法 ， 第 一 个 参数 表示 执行 哪个 对 象 的 方法 ， 剩 下 的 参数 是 执行 方法 时 需要 传 
入 的 参数 ， 私 有 方法 的 执行 必须 在 调用 invoke 之 前 加 上 一 句 “method.setAccessible(true):”。 


Class clazz = Class. forName("Reflection.Student"); 
Method method-null; 
Method[] methods-null; 


methods = clazz.getMethods(); 
for (Method mth:methods) { 
System. out.print (mth.getName()+" "); 
} 
System.out.println(); 


method = clazz.getMethod ("Student PublicMethod", String.class) ; 
System.out.print (method.getName()*" "); 
System.out.println(); 


methods = clazz.getDeclaredMethods(); 
for(Method mth:methods) { 

System. out.print (mth.getName()+" "); 
} 
System. out.println(); 


method = clazz.getDeclaredMethod ("StudentPrivateMethod", String.class) ; 
System. out.print (method.getName()+" "); 
System.out.println(); 


Object obje = clazz.newInstance(); 

method.setAccessible (true); 

String result-(String) method.invoke(obje,"inputParams") ; 
System.out.println(result); 


输出 结果 : 


«terminated» ReflectionTest [Java Application] C:\Program Files\Java\jre1.8. 
StudentPublicMethod setStudentId getStudentId getName setName 
StudentPublicMethod 

StudentPrivateMethod StudentPublicMethod setStudentId getStudentId 
StudentPrivateMethod 

inputParams 


onPrivateMethod PersonPublicMethod wi 


上 面 我 们 基本 可 以 实现 通过 类 名 创建 对 象 、 通 过 方法 名 执行 方法 。 类 名 和 方法 名 都 是 字符 
串 ， 我 们 可 以 把 它们 放 到 一 个 配置 文件 中 ， 根 据 配置 文件 来 执行 方法 ， 这 样 就 有 点 类 似 基 于 
XML 的 Spring 了 。 
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2. 描述 字段 Field 


描述 字段 Field 方法 的 使 用 和 描述 方法 Method 中 方法 的 使 用 有 点 类 似 ， 也 是 4 个 获取 字 
段 的 方法 CgetFields, getField. getDeclaredFields, getDeclaredField) 。 


e ”getFields: 获得 某 个 类 的 所 有 公共 (public) 字段 ， 包 括 父 类 中 的 字段 。 

e getField: 获取 某 个 类 public 成 员 变 量 中 指定 变量 名 的 字段 ， 包 括 基 类 。 

e  getDeclaredFields: 获得 某 个 类 所 有 声明 的 字段 ， 包 括 public. private 和 protected， 但 是 不 
包括 父 类 的 声明 字段 。 

*  getDeclaredField: 获取 某 个 类 的 所 有 成 员 变量 指定 变量 名 的 字段 ， 不 包括 基 类 。 


Class clazz = Class. forName("Reflection.Student"); 
System. out. println("--------- getDeclaredFields--------- "y 
Field[] fields = clazz.getDeclaredFields(); 
for(Field field: fields)( 
System. out.print (field.getName()+" "); 
} 
System.out.println(); 
System.out.println("--------- getFields--------- "ys 
fields - clazz.getFields(); 
for(Field field: fields)( 
System.out.print(field.getName()*" "); 
) 
System.out.println(); 


System.out.println("--------- getDeclaredField--------- "mys 
Field field = clazz.getDeclaredField("StudentId") ; 
field.setAccessible (true) ; 

System. out.println(field.getName() ); 


System. out. println("--------- getField-------- "s 


field - clazz.getField("StudentId"); 
System.out.println(field.getName()); 


StudentId 


上 面 通过 反射 获取 字段 ， 得 到 字段 之 后 就 是 获取 或 设置 字段 的 值 了 。 如 果 字 段 是 私有 的 ， 


12 


那么 不 管 是 读 值 还 是 写 值 ， 都 必须 先 调用 setAccessible(true) 方 法 ， 比 如 在 Person 类 中 ， 字 段 
name 字段 是 私有 的 。 


Class clazz = Class.forName("Reflection.Person"); 
Person person = new Person("CYW"); 

// 获 取 私 有 字段 的 值 

Field field = clazz.getDeclaredField ("Name"); 
// 由 于 是 私有 字段 ， 因 此 需要 使 用 setAccessible (true) 
field.setAccessible (true) ; 

Object val = field.get (person); 

System. out.println (val); 

// 改 变 私有 字段 的 值 

field.set(person, "ivan"); 

System. out.print1n(person.getName () ); 


CYW 


ivan 
3. 描述 构造 器 Constructor 


先 介绍 一 下 描述 构造 函数 Constructor 用 到 的 方法 ， 主 要 还 是 4 个 : getConstructors、 
getDeclaredConstructors、getConstructor、getDeclaredConstructor。 和 前 面 Method, Field 用 的 
方法 进行 比较 ， 举 一 反 三 ， 我 们 也 能 大 概 了 解 这 几 个 方法 的 使 用 。 其 实 ， 在 编程 中 有 好 多 体现 
哲学 思想 的 地 方 ， 有 正 有 反 ， 有 阴 有 阳 ， 学 会 思考 ， 这 样 可 以 以 点 带 面 、 触 类 旁 通 。 

* getConstructors: 获取 对 应 类 中 public 类 型 的 构造 函数 ， 且 只 获取 当前 类 的 构造 函数 。 

* getConstructor: 获取 对 应 类 中 public 指定 参数 类 型 的 构造 函数 ， 且 只 获取 当前 类 的 构造 


dd. 
*  getDeclaredConstructors: 获取 对 应 类 中 所 有 构造 函数 ,包括 私有 构造 函数 ， 且 只 获取 当前 
类 的 构造 函数 。 
* ”getDeclaredConstructor: 获取 对 应 类 中 指定 参数 类 型 的 方法 ， 包 括 私有 构造 函数 ， 且 只 获 
取 当 前 类 的 方法 。 
String className = "Reflection.Student"; 


Class<Student> clazz = (Class<Student>) Class. forName(className) ; 


// 指 定 成 父 类 之 后 实际 还 是 获取 子 类 的 构造 函数 
Constructor<Person> [] constructors = 
(Constructor<Person>[]) Class.forName(className) . 
getConstructors(); 


for (Constructor<Person> constructor: constructors) { 


System. out.printin("getConstructors:"+constructor) ; 
} 
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Constructor<Student> [] constructorsa = 
(Constructor<Student>[]) Class.forName(className) . 
getDeclaredConstructors (); 


for (Constructor<Student> constructor: constructorsa) { 
System. out. printin("getDeclaredConstructors:"+constructor) ; 


// 通 过 getConstructor 获取 公有 构造 函数 
Constructor<Student> Constructor = 
clazz.getConstructor(String.class, String.class) ; 
System. out.println("getConstructor:"+constructor) ; 
Student obj = constructor.newInstance("cyw", "123456"); 
System.out.println(obj.getName()); 


// 通 过 getDeclaredConstructor 获取 私有 构造 函数 

constructor = clazz.getDeclaredConstructor (String.class) ; 
System. out.print1n("getDeclaredConstructor:"+constructor) ; 
// 对 于 私有 构造 函数 在 初始 化 之 前 要 设置 setAccessible (true) 
constructor.setAccessible (true) ; 

obj = constructor.newInstance ("cyw"); 

System. out.printi1n (obj .getName () ); 


getConstructors:public Reflection.Student( java.lang.String, java.lang.String) 
getConstructors:public Reflection.Student() 
getDeclaredConstructors:public Reflection.Student( java.lang.String, java.lang.String) 


getDeclaredConstructors:private Reflection. Student( java.lang.String) 
getDeclaredConstructors:public Reflection.Student() 

getConstructor:public Reflection.Student( java.lang.String, java.lang.String) 
cyw 

getDeclaredConstructor:private Reflection.Student(java.lang.String) 


4. 描述 注解 Annotation 


描述 注解 主要 用 到 getAnnotation(Class<A> annotationClass) 方 法 ， 返 回 该 元 素 指 定 类 型 的 
注解 ， 否 则 返回 null。 


String className = "Reflection.Student"; 
Class<Student> clazz = (Class<Student>) Class. forName(className) ; 
CustomDescriptions customDescriptions 
=clazz.getAnnotation (CustomDescriptions.class) ; 
for (CustomDescription h: customDescriptions.value()) { 
System. out.printin ("description + h.description()); 
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description: FÆ 
description:A 


1.3 小 结 


我 们 回顾 一 下 这 一 章 的 主要 内 容 : 在 注解 部 分 ， 学 习 了 注解 的 定义 、 注 解 的 理解 、 内 置 注 
解 、 元 注解 ， 通 过 自 定义 注解 理解 注解 继承 、 多 注解 及 注解 生命 周期 ; 在 反射 部 分 ， 了 解 反射 
机 制 、Class 类 的 理解 , 通过 实例 掌握 反射 中 Method、Field、Constructor、Annotation 相关 API 
的 使 用 ， 为 后 续 学 习 Spring 框架 打下 基础 。 
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第 2 章 
-Spring Bi > 


在 上 一 章节 中 ， 我 们 学 习 了 Java 的 注解 与 反射 ， 在 这 一 章节 我 们 将 了 解 一 下 Spring 框架 ， 并 
学 习 Spring 框架 中 重要 的 编程 思想 控制 反 转 (IOC) 、 面 向 切面 编程 (AOP) 。 语 言 只 是 工具 ， 最 
重要 的 是 编程 思想 。 掌 握 了 编程 思想 ， 不 仅 是 Java， 其 他 编程 语言 也 就 容易 学 习 了 。 


本 章 主要 涉及 的 知识 点 : 


Spring 概述 : 了 解 Spring 框架 的 起 源 、 莘 介 、 结 构 。 

依赖 注入 : 什么 是 依赖 注入 ?依赖 注入 的 好 处 是 什么 ? 

控制 反 转 : 什么 是 控制 反 转 ?依赖 注入 与 控制 反 转 的 联系 是 什么 ? 

面向 切面 编程 : 什么 是 面向 切面 编程 ?面向 切面 编程 的 原理 。 

实例 应 用 : 通过 本 章 IOC、AOP 示例 ， 演 示 Spring 中 IOC, AOP 的 简单 应 用 ， 通 过 动 
手 实践 加 深 对 IOC、AOP 的 理解 。 


Spring 框架 介绍 


本 节 主 要 对 Spring 框架 进行 简单 介绍 ， 了 解 框架 起 源 、 框 架 组 成 结构 ， 对 Spring 框架 有 
-个 大 概 的 认识 。 


2.1.1 起 源 


首先 ， 追根 溯源 ， 了 解 它 是 怎么 来 的 。 在 Spring 框架 出 现 之 前 ， 使 用 EJB 开发 J2EE 应 用 
可 没 那么 容易 。EJB 要 严格 地 实现 各 种 不 同类 型 的 接口 ,代码 复 用 性 低 ， 配置 也 比较 复杂 和 单 
调 ， 同 样 使 用 INDI 进行 对 象 查找 的 代码 也 是 单调 而 枯燥 ， 而 且 EIB 不 容易 学 ， 开 发 效率 低 。 
Spring 出 现 的 初衷 就 是 为 了 解决 类 似 的 这 些 问 题 。 

Spring 最 大 的 目的 之 一 就 是 使 J2EE 开发 更 加 容易 。 同 时 ，Spring 不 仅仅 是 一 个 单 层 的 框 
架 ， 而 是 类 似 一 个 平台 或 者 生态 体系 。 在 这 个 平台 或 者 生态 体系 中 ， 可 以 将 Struts. Hibernate 
等 单 层 框架 最 佳 的 方式 融合 在 一 起 ,为 企业 级 应 用 提供 完美 的 解决 方案 。Spring 的 形成 ,最 初 
KÄ Rod Jahnson 所 著 的 一 本 很 有 影响 力 的 图 书 《Expert One-on-One J2EE Design and 
Development) (HARF 2002 年 ) ， 就 是 在 这 本 书 中 第 一 次 出 现 了 Spring 的 一 些 核心 思想 。 
另外 ，《Expert One-on-One J2EE Development without EJB》 更 进一步 地 阐述 了 在 不 使 用 EJB 
开发 PEE 企业 级 应 用 的 一 些 设计 思想 和 具体 的 做 法 。 
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2.1.2 简介 


THET Spring 框架 的 起 源 之 后 ,下 面 来 了 解 一 下 Spring 到 底 是 什么 .用 一 句 话 概括 ,Spring 
就 是 一 个 开源 的 轻 量 级 的 控制 反 转 〈IoC) 和 面向 切面 CAOP) 的 容器 框架 。 下 面 来 分 析 一 下 
这 句 话 。 

CD 开源 : 因为 开源 、 免 费 ， 用 户 无 须 经 过 任何 人 同意 即 可 修改 代码 ， 可 控制 性 强 ， 不 
受 他 人 限制 。 

(2) 轻 量 级 : 从 大 小 与 开销 两 方面 而 言 ，Spring 都 是 轻 量 的 。 完 整 的 Spring 框架 可 以 在 
一 个 大 小 只 有 IMB 多 的 JAR 文件 里 发 布 ， 并 且 Spring 所 需 的 处 理 开 销 也 是 微不足道 的 。 此 
外 ，Spring 是 非 侵 入 式 的 ，Spring 应 用 中 的 对 象 不 依赖 于 Spring 的 特定 类 。 

G) 控制 反 转 : 软件 设计 中 通常 用 耦合 度 和 内 聚 度 作 为 衡量 模块 独立 程度 的 标准 ， 划 分 
模块 的 一 个 准则 就 是 高 内 聚 低 耦 合 ，Spring 通过 控制 反 转 技术 降低 了 耦合 度 。 

(4) 面向 切片 : Spring 支持 面向 切片 的 编程 ， 允 许 通过 分 离 应 用 的 业务 逻辑 与 系统 级 服 
务 进行 内 聚 性 的 开发 ， 应 用 对 象 只 需 实现 业务 逻辑 ， 它 们 并 不 负责 (甚至 是 意识 ) 其 他 系统 级 
关注 点 ， 例 如 日 志 或 事务 支持 。 

(5) 容器 : 容器 就 是 用 来 装 东西 的 。Spring 容器 包含 并 管理 应 用 对 象 的 配置 和 生命 周期 。 

(6) 框架 : Spring 可 以 将 简单 的 组 件 配置 、 组 合成 为 复杂 的 应 用 ， 相 当 于 是 一 个 脚手架 ， 
开发 者 要 做 的 就 是 把 组 件 放 进去 ， 实 现 业 务 逻 辑 。 


2.1.3 ”框架 结构 
Spring 框架 结构 如 图 2-1 所 示 。 


Data 
Access/Integration 


JDBC ORM Webmvc 


OxM JMS 


WebFlux 
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Spring 由 20 多 个 模块 组 成 ， 可 以 分 为 核心 容器 (Core Container) 、 数 据 访问 /集成 (Data 
Access/Integration) 、Web、 面 向 切面 编程 (AOP, Aspect Oriented Programming) 、 设 备 
(Instrumentation) 、 消 息 发 送 (Messaging) 和 测试 (Test) 。 


1. 核心 容器 

核心 容器 包含 spring-core 、spring-beans ~ spring-context spring-context-support 和 
spring-expression (Spring Expression Language) 这些 模 块 。 

spring-core 和 spring-beans 构成 了 框架 最 基础 的 部 分 ， 包 括 控制 反 转 和 依赖 注入 功能 。 

spring-context 是 基于 spring-core 和 spring-beans 构建 的 , 提供 了 一 种 以 框架 风格 来 访问 对 
象 的 方式 ， 类 似 于 INDI 注册。ApplicationContext 接口 是 spring-context 的 焦点 。 

spring-context-support 为 集成 第 三 方 库 〈 如 定时 器 Quartz) 提供 支持 。 

spring-expression 提供 了 一 种 强大 的 表达 式 语言 ， 可 以 在 运行 时 查询 和 操作 对 象 。 

2. AOP 

spring-aop 模块 提供 了 一 个 AOP 面向 切面 编程 的 实现 。 

spring-aspects 模块 提供 与 Aspect 的 集成 。 

spring-instrument 模块 提供 一 些 类 级 的 工具 支持 和 ClassLoader 级 的 实现 ， 用 于 服务 器 。 
spring-instrument-tomeat 模块 针对 tomcat 的 instrument 实现 。 

3. 消息 发 送 

从 Spring 4 开始 包含 了 一 个 spring-messaging 模块 ， 对 Spring 集成 项 目 Message、 
MessageChannel 和 MessageHandler 进行 了 重要 的 抽象 ， 是 基于 消息 发 送 应 用 的 基础 。 

4. 数据 访问 /集成 


数据 访问 /集成 层 包 含 JDBC (spring-jdbc) 、ORM (spring-orm) 、OXM (spring-oxm) 、 
JMS (spring-jms) 和 事务 (spring-tx) 模块 。 


5. Web 


Web 层 包含 spring-web、spring-webmvc、spring-websocket 和 spring-webflux 模块 。 其 中 ， 
spring-web 提供 了 面向 Web 集成 的 基本 特性 ， 比 如 文件 上 传 功能 。Spring-webmvc 模块 包含 了 
Spring 的 MVC 和 REST Web Service 实现 。spring-webflux 是 一 个 新 的 非 堵塞 函数 式 Reactive 
Web 框架 ， 可 以 用 来 建立 异步 的 、 非 阻塞 、 事 件 驱动 的 服务 ， 并 且 扩 展 性 非常 好 。 

6. 测试 


Spring-test 模块 支持 Spring 组 建 JUnit 和 TestNG 的 单元 测试 和 集成 测试 。 
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依赖 注入 DI 与 控制 反 转 IOC 


本 节 主 要 介绍 依赖 注入 与 控制 反 转 的 基本 概念 ， 理 解 什么 是 依赖 注入 、 什 么 是 控制 反 转 。 
在 此 基础 上 通过 示例 动手 操作 加 深 理解 。 


2.2.1 什么 是 依赖 注入 


从 汉字 的 字面 意思 理解 ， 可 以 把 “依赖 注入 ”分 为 两 个 词 ， 一 个 是 “依赖 ”， 一 个 是 “ 注 
入 ”。 那 什么 是 依赖 、 什 么 是 注入 呢 ? 依 赖 是 依靠 别人 或 事物 而 不 能 自立 或 自给 ， 通 俗 的 理解 
就 是 ， 不 是 自身 的 ， 但 没有 就 活 不 下 去 ， 比 如 入 没有 了 空气 、 水 、 阳 光 ， 那 就 活 不 下 去 ， 所 以 
人 依赖 空气 、 水 、 阳 光 。 注 入 是 之 前 内 部 没有 通过 外 部 灌 入 的 。 
上 面 是 从 字面 意思 理解 了 一 下 依赖 注入 , 接着 从 编程 的 角度 分 析 一 下 。 依赖 注入 是 组 件 之 
间 依 赖 关 系 由 容器 在 运行 期 决定 的 , 即 由 容器 动态 地 将 某 个 依赖 关系 注入 到 组 件 之 中 。 依赖 注 
入 的 目的 并 非 为 软件 系统 带 来 更 多 功能 ， 而 是 为 了 解 看 ， 提 升 组 件 重用 的 频率 ， 并 为 系统 搭建 一 
个 灵活 、 可 扩展 的 平台 。 通 过 依赖 注入 机 制 ， 我 们 只 需要 通过 简单 的 配置 ， 而 无 须 任何 代码 就 可 
以 指定 目标 需要 的 资源 ， 完 成 自身 的 业务 逻辑 ， 不 需要 关心 具体 的 资源 来 自 何 处 、 由 谁 实现 。 
。 依赖 注入 是 组 件 之 间 依 赖 关 系 由 容器 在 运行 期 决定 的 , 即 由 容器 动态 地 将 某 个 依赖 关 
系 注 入 到 组 件 之 中 。 这 句 话 总 结 依赖 注入 的 核心 原理 ， 比 如 分 别 把 人 【Person) 和 空 
气 (Air) 都 当 作 一 个 组 件 ( 类 ) ， 人 依赖 空气 ， 那 么 这 个 依赖 关系 不 是 人 和 空气 两 
个 组 件 关联 的 ， 需 要 一 个 容器 决定 ， 而 且 不 是 一 开始 就 决定 的 ， 是 运行 期 决定 的 。 
。 依赖 注入 的 目的 并 非 为 软件 系统 带 来 更 多 功能 ,而 是 为 了 解 耦 , 提升 组 件 重用 的 频率 ， 
并 为 系统 搭建 一 个 灵活 、 可 扩展 的 平台 。 这 句 话 是 使 用 依赖 注入 的 目的 。 使 用 依赖 注 
入 可 以 进一步 解 耦 ， 也 是 软件 设计 中 高 内 聚 低 耦 合 的 体现 。 
。 通过 依赖 注入 机 制 , 我 们 只 需要 通过 简单 的 配置 , 而 无 须 任何 代码 就 可 以 指定 目标 需 
要 的 资源 ， 完 成 自身 的 业务 丈 辑 ,不 需要 关心 具体 的 资源 来 自 何 处 、 由 谁 实现 。 这 句 
话 是 实现 依赖 注入 的 方法 ， 通 过 简单 配置 就 能 实现 依赖 注入 。 
理解 DI 的 关键 是 : “ 谁 依 赖 谁 ， 为 什么 需要 依赖 ， 谁 注入 谁 ， 注 入 了 什么 ”， 接 着 使 用 
人 和 空气 来 深入 分 析 一 下 : 
谁 依赖 谁 : 人 依赖 空气 。 
为 什么 需要 依赖 人 需要 空气 ， 没 有 空气 ， 人 就 不 存在 ， 就 是 一 个 空 对 象 。 
HIAR: 人 通过 容器 注入 空气 。 
注入 了 什么 : 注入 了 人 所 需要 的 空气 。 


2.2.2 ”什么 是 控制 反 转 


与 依赖 注入 一 样 ,我 们 还 是 先 从 字面 意思 理解 一 下 控制 反 转 。 它 也 可 以 分 为 两 个 词 , 一 个 
是 “控制 ”， 一 个 是 “ 反 转 ”。 那 什么 是 控制 ， 什 么 又 是 反 转 呢 ? 
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e 控制: 为 掌握 住 对 象 不 使 任意 活动 或 超出 范围 ; 或 使 其 按 控制 者 的 意愿 活动 。 
© RÀ: 向 相反 的 方向 转动 。 


上 面 是 从 中 文字 面 对 控 制 反 转 的 理解 ,下 面 从 编程 的 角度 分 析 一 下 。IOC 意味 着 将 你 设计 
好 的 对 象 交 给 容器 控制 ， 而 不 是 传统 的 在 你 的 对 象 内 部 直接 控制 。 理 解 IOC 的 关键 是 : “ 谁 
控制 谁 ， 控 制 什 么 ， 为 何 是 反 转 〈 有 反 转 就 应 该 有 正 转 了 ) ， 哪 些 方面 反 转 了 ”。 我 们 接着 使 
用 人 和 空气 来 深入 分 析 一 下 : 
e 谁 控制 谁 ， 控 制 什 么 : 以 往 我 们 是 通过 new 关键 字 来 创建 对 象 的 ， 比 如 人 (Person) 依赖 
空气 (Air) ， 在 Person 中 如 果 要 使 用 Air 对 象 ， 就 需要 通过 New 关键 字 来 主动 创建 ， 在 
IOC 中 有 一 个 专门 的 容器 来 创建 这 些 对 象 ， 即 由 IOC 容器 来 控制 对 象 的 创建 。 
> RHR? RA IOC 容器 控制 对 象 了 。 
> 控制 什么 ? 主要 控制 了 外 部 资源 获取 (不 只 是 对 象 ， 还 包括 文件 等 ) 。 
e “为何 是 反 转 ， 哪 些 方面 反 转 了 : 有 反 转 就 有 正 转 ， 正 转 就 是 我 们 通过 New 主动 获取 依赖 
AX. 反 转 则 是 由 容器 来 帮忙 创建 及 注入 依赖 对 象 。 
> 为 何 是 反 转 ? 因为 由 容器 帮 我 们 查找 及 注入 依赖 对 象 ， 对 象 只 是 被 动 地 接受 依赖 对 
象 ， 所 以 是 反 转 。 
> 哪些 方面 反 转 了 ? 依赖 对 象 的 获取 被 反 转 了 。Air 对 象 通过 容器 注入 给 Person 对 象 。 


2.2.3 ”依赖 注入 的 优 缺 点 


可 能 有 人 会 纳闷 为 什么 只 介绍 使 用 依赖 注入 的 优 缺 点 , 那 控 制 反 转 就 没有 优 缺 点 吗 ? 其实 
它们 是 同一 个 概念 的 不 同 角度 描述 , 由 于 控制 反 转 概念 比较 含糊 (可 能 只 是 理解 为 容器 控制 对 
象 这 一 个 层面 ， 很 难 让 人 想到 谁 来 维护 对 象 关 系 ) ， 所 以 2004 年 大 师 级 人 物 Martin Fowler 
又 给 出 了 一 个 新 的 名 字 : “依赖 注入 ”。 相 对 IOC 而 言 ，“ 依 赖 注入 ”明确 描述 了 “被 注入 
对 象 依赖 IOC 容器 配置 依赖 对 象 ”。 

俗话 说 ， 每 个 硬币 都 有 两 面 。 同 样 ，IOC 也 是 有 优点 和 缺点 的 。 

优点 ， 也 是 使 用 依赖 注入 的 目的 : 实现 组 件 之 间 的 解 耦 ， 提 高 程序 的 灵活 性 和 可 维护 性 ， 
提升 组 件 重用 的 频率 ， 并 为 系统 搭建 一 个 灵活 、 可 扩展 的 平台 。 

缺点 也 是 存在 的 。 一 是 它 创 建 对 象 的 方式 变 复杂 了 。 二 是 因为 使 用 反射 来 创建 对 象 , 所 以 
在 效率 上 会 有 些 损耗 。 但 相对 于 程序 的 灵活 性 和 可 维护 性 来 说 ,这 点 损耗 是 微不足道 的 。 三 是 
使 用 XML 进行 配置 时 太 复 杂 , 一 旦 类 有 改变 , XML 就 需要 改变 。 有 了 注解 之 后 , 与 使 用 XML 
进行 配置 相 比 简单 很 多 。 


2.2.4 10cC 实例 
光 说 不 练 假 把 式 ， 特 别 是 IT 技术 ， 经 常会 出 现 看 能 看 懂 但 写 不 出 来 的 炮 熔 局 面 。 上 面 分 
析 了 一 下 依赖 注入 与 控制 反 转 ， 本 节 将 通过 示例 来 加 深 理解 。 这 里 还 是 使 用 人 与 空气 的 例子 。 
人 依赖 空气 ， 在 传统 的 方式 创建 两 个 类 : 一 个 是 Person 类 ， 一 个 是 CleanAir 类 。 


Public class CleanAir { 
GOverride 
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public String toString() { 


return "CleanAir"; 
} 
} 
Public class Person { 


public Person(CleanAir air) { 


this.air = air; 
} 
CleanAir air; 


public void Breath() 
t 
System.out.print(this.air.toString()); 
) 
) 


上 面 两 个 类 实现 了 依赖 的 关系 , 还 有 就 是 注入 。 在 了 解 注入 之 前 , 我 们 还 有 一 个 问题 要 思 
考 。 有 这 样 一 句 话 : 世界 上 唯一 不 变 的 就 是 变化 。 之 前 干净 的 空气 不 复 存在 ， 而 Person 依赖 
的 不 再 是 CleanAir, 而 是 比 CleanAir 更 有 内 涵 的 DirtyAir。 如 果 还 是 按照 上 面 的 方式 来 ， 那 就 
需要 在 增加 一 个 DirtyAir 类 的 同时 修改 Person。 这 种 强 依赖 有 很 大 的 弊端 ,一 个 地 方 变化 引起 
其 他 地 方 变化 ,而且 改变 的 只 是 Air, 但 Person 也 要 改变 ,怎么 样 才 能 尽量 减少 修改 的 地 方 呢 ? 
于 是 面向 接口 的 编程 出 现 了 。 下 面 先 定义 一 个 接口 IAir， 类 CleanAir 实现 接口 IAir, 在 Person 
中 不 再 直接 依赖 CleanAir, 而 是 依赖 接口 IAir, 这 样 即使 是 DirtyAir 也 只 需要 给 Person 修改 不 
同 的 Air 就 行 了 。 这 个 注入 的 过 程 ， 利 用 Spring 框架 只 需要 改 一 下 配置 即 可 实现 。 
public interface IAir {} 
public class CleanAir implements IAir { 
@Override 
public String toString() { 
return "CleanAir"; 
} 
public class Person { 
public Person(IAir air) { 
this.air = air; 


IAir air; 
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public void Breath () 
{ 


System.out.print (this.air.toString()); 


public class DirtyAir implements IAir { 
GOverride 
public String toString() ( 


return "DirtyAir"; 


) 


上 面 定义 IAir 接口 算是 对 依赖 关系 的 优化 ， 降 低 了 人 与 空气 的 耦合 度 ， 但 是 并 没有 使 用 
New 关键 字 创建 对 象 ， 只 是 定义 了 依赖 关系 。 下 面 用 Spring 实现 注入 。 


(1) 创建 一 个 Maven Project，archetype 选择 quickstart， 如 图 2-2 所 示 。 


圈 New Maven Project 


New Maven project 
Select an Archetype 


Catalog: All Catalogs 


Filter: 


Group Id Artifact Id 
org.apache.maven.archetypes_maven-archetype-plugin 
org.apache.maven.archetypes_maven-archetype-plugin-site 
org.apache.maven.archetypes_maven-archetype-portlet 
maven-archetype-profiles 


Version 
12 

11 

1.0.1 
1.0-alpha-4 


maven-archetype-quickstart 


11 


] 


maven-archetype-site 
| org.apachemaven.archetypes maven-archetype-site-simple 


11 
11 


An archetype which contains a sample Maven project. 


EZ Show the last version of Archetype only [Include snapshot archetypes 


> Advanced 


图 2-2 


(2) 创建 之 后 , 既然 要 使 用 Spring 框架 来 实现 注入 , 那 肯定 要 在 项 目 中 引入 Spring HEW, 


配置 pom.xml， 添 加 依赖 。 


(D) 在 properties 节点 配置 要 引入 Spring 的 版 本 号 ， 这 里 用 的 是 5.0.0.RELEASE。 


<spring.version>5.0.0.RELEASE</spring.version> 
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Q 引入 。 


<dependency> 

<groupId>org. springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 
<version>${spring.version}</version> 
</dependency> 


(3) 实现 依赖 注入 。 
前 面 创建 的 IAir 接口 、Person 类 、CleanAir 类 、DirtyAir 类 实现 了 依赖 关系 ， 但 是 怎么 让 
Spring 框架 识别 到 呢 ? 不 可 能 把 各 个 类 创建 好 就 结束 了 ， 还 需要 进行 配置 才能 让 Spring 知道 哪 
些 是 组 件 。 这 里 对 Person 类 、CleanAir 类 、DirtyAir 类 在 上 面 定 义 的 基础 上 进行 修改 。 


@Component 

Public class CleanAir implements IAir { 
@Override 
public String toString() { 


return "CleanAir"; 


GComponent 

public class DirtyAir implements IAir ( 
GOverride 
public String toString() ( 


return "DirtyAir"; 


GComponent 
public class Person ( 


GAutowired // 对 构造 函数 进行 标注 
public Person(@Qualifier("dirtyair")IAir air) { 


this.air = air; 


IAir air; 
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public void Breath() 
t 
System.out.print(this.air.toString()); 


} 


在 上 面 的 代码 中 使 用 了 @Component 将 类 注解 成 组 件 ， 使 用 @Autowired 将 LAir 类 型 对 象 
YEA Person 中 。CleanAir 类 、DirtyAir 类 都 实现 了 IAir 接口 ， 怎 么 让 Person 具体 注入 哪个 对 
象 呢 ? 使 用 @Qualifier 关键 字 来 进行 区 分 , 这 里 使 用 的 是 qualifier=dirtyair。 同 时 这 些 组 件 定义 
之 后 还 要 告诉 Spring 框架 组 件 位 置 在 哪 ， 所 以 在 scr/main/resources 下 新 建 了 
ApplicationContext.xml 进行 配置 。 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/context" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd" 


<context:component-scan base-package-"com.demo.model"/» 
<bean id-"CleanAir" class="com.demo.model.CleanAir"> 
<qualifier value="cleanair"/> 
</bean> 
<bean id-"DirtyAir" class="com.demo.model.DirtyAir"> 
<qualifier value="dirtyair"/> 
</bean> 
<bean id="person" class-"com.demo.model.Person"/» 
</beans> 


(4) 测试 。 
在 main 中 获取 到 应 用 上 下 文 ， 通 过 getBean 方法 获取 Person 对 象 ， 然 后 调用 Breath() 方 
法 。 不 了 解 ClassPathXmlApplicationContext、getBean 这 些 方法 也 没关系 ， 在 后 面 的 章节 会 有 
详细 介绍 。 
public static void main( String[] args ) 
{ 
ApplicationContext context-new ClassPathXmlApplicationContext (new 
String[]("ApplicationContext.xml"]); 
BeanFactory factory-context; 


Person person- (Person) factory.getBean ("person"); 
person.Breath(); 
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DirtyAir 


如 果 想 使 用 CleanAir 对 象 , 只 需要 把 Person 类 中 @Qualifier 注解 value 的 值 改 为 CleanAir 
对 应 的 beanld: cleanair。 


(5) 小 结 
参考 上 面 的 示例 思考 2.2.1 和 2.2.2 节 中 的 概念 ,就 会 发 现 依赖 注入 、 控 制 反 转 其 实 也 不 难 。 
E 解 了 依赖 注入 、 控 制 反 转 对 后 面 Spring 框架 的 学 习 会 有 更 大 的 帮助 。 


m 


2 .3 面向 切面 编程 


本 节 主 要 认识 横 切 、 纵 切 ， 理 解 什么 是 AOP (Aspect-Oriented Programming， 面 向 切面 编 
FE) 以 及 AOP 的 实现 原理 。 在 此 基础 上 通过 示例 动手 操作 加 深 理 解 。 


2.3.1 认识 横 切 和 纵 切 


首先 认识 一 下 什么 是 横 切 、 纵 切 ， 这 就 要 利用 生物 方面 的 知识 了 。 切 面 的 方向 是 这 样 规 定 
的 : 拿 植物 的 茎 举例 ， 纵 切 就 是 沿 长 轴 来 切 ， 横 切 即 是 垂直 与 纵 切 的 切 法 。 编 程 相对 来 说 是 比 
较 抽 象 的 ， 有 时 候 我 们 通过 身边 的 事物 来 将 抽象 的 具体 化 ， 这 样 也 能 更 容易 理解 。 

利用 百度 搜索 “ 横 切 ”“ 纵 切 ” 时， 首先 搜 出 来 的 结果 是 剖 宫 产 的 结果 ， 内 容 是 这 样 描述 
的 : “由 于 人 体 和 血管 、 神 经 系统 等 都 是 纵向 的 走向 ， 所 以 纵 切 更 有 利于 皮肤 和 伤口 的 钝 合 ， 
通常 在 1 年 到 2 年 就 可 以 彻底 恢复 。 但 纵 切 的 缺点 是 伤口 较 大 , 会 留 下 明显 的 疤痕 , 会 影响 美 
观 。 横 切 的 方法 出 血 较 少 ， 并 且 出 现 伤口 感染 的 机 率 要 低 于 纵 切 ， 所 以 安全 性 比 纵 切 高 一 些 ， 
只 是 不 利 再 次 进行 剖 富 产 手 术 。” 这 里 的 横 切 、 纵 切 与 编程 中 的 还 是 挺 相 似 的 。 


2.8.0 什么 是 AOP 


AOP， 可 以 说 是 OOP (Object-Oriented Programing， 面 向 对 象 编程 ) 的 补充 和 完善 。OOP 
引入 封装 、 继承 和 多 态 性 等 概念 来 建立 一 种 对 象 层次 结构 , 用 以 模拟 公共 行为 的 一 个 集合 。 当 
我 们 需要 为 分 散 的 对 象 引 入 公共 行为 (日 志 、 安 全、 事务 ) 的 时 候 ，OOP 则 显得 无 能 为 力 。 
也 就 是 说 ，OOP 允许 你 定义 从 上 到 下 的 关系 ， 但 并 不 适合 定义 从 左 到 右 的 关系 。 例 如 ， 日 志 
功能 。 日 志 代码 往往 水 平地 散布 在 所 有 对 象 层 次 中 , 而 与 它 所 散布 到 的 对 象 的 核心 功能 毫 无 关 
系 。 对 于 其 他 类 型 的 代码 ， 如 安全 性 、 异 常 处 理 和 透明 的 持续 性 也 是 如 此 。 这 种 散布 在 各 处 的 
无 关 的 代码 被 称 为 横 切 〈cross-cutting) 代码 。 在 OOP 设计 中 ， 它 导致 了 大 量 代码 重复 、 模 块 
间 的 藉 合 度 高 ， 不 利于 各 个 模块 的 重用 。 

AOP 技术 则 恰恰 相反 ， 它 利用 一 种 称 为 “ 横 切 ”的 技术 ， 剖 解 开 封装 的 对 象 内 部 ， 并 将 
那些 影响 了 多 个 类 的 公共 行为 封装 到 一 个 可 重用 模块 ， 并 将 其 命名 为 “Aspect”， 即 切面 。 所 
谓 “ 切 面 ”， 简 单 地 说 ， 就 是 将 那些 与 业务 无 关 ， 却 为 业务 模块 所 共同 调用 的 逻辑 或 责任 封装 
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起 来 , 便于 减少 系统 的 重复 代码 , 降低 模块 间 的 耦合 度 , 并 有 利于 未 来 的 可 操作 性 和 可 维护 性 。 
2.8.8 AOP 原理 


AOP 实际 上 是 由 目标 类 的 代理 类 实现 的 。AOP 代理 其 实 是 由 AOP 框架 动态 生成 的 一 个 
对 象 ， 该 对 象 可 作为 目标 对 象 使 用 。AOP 代理 包含 了 目标 对 象 的 全 部 方法 〈 见 图 2-3) ， 但 
AOP 代理 中 的 方法 与 目标 对 象 的 方法 存在 差异 ，AOP 方法 在 特定 切入 点 添加 了 增强 处 理 ， 并 


回调 了 目标 对 象 的 方法 。 
AOP 杠 染 织 入 的 增强 处 理 
i 回调 目标 对 象 的 方法 
g = 
AOP 框架 织 入 的 增强 处 理 
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由 于 是 代理 实现 AOP， 因 此 有 必要 学 习 一 下 人 代理。 下面 通过 实例 一 步 一 步 地 了 解 静态 代 
理 和 动态 代理 。 新 建 一 个 ServiceImplA 类 ， 实 现 IService 接口 ， 想 在 调用 service 方法 前 后 增 
加 日 志 打印 或 为 service 方法 增加 try catch， 那 么 该 怎么 做 呢 ? 


package AOP; 


public interface IService { 

public void service(String name) throws Exception; 
} 
package AOP; 


public class ServiceImplA implements IService { 


@Override 
public void service(String name) throws Exception { 
System. out.println("ServiceImplA name"+name) ; 
H 
H 


1. 在 每 处 调用 的 地 方 增加 日 志和 try catch 


这 也 是 一 种 方法 ， 但 缺点 是 很 明显 的 ， 就 是 每 处 都 要 更 改 ， 量 也 会 很 大 ， 显 然 不 可 取 。 这 
里 是 每 个 点 都 要 加 , 一 个 方法 可 能 被 调用 多 处 , 就 要 写 多 次 。 而 且 以 后 再 进行 修改 时 也 不 方便 ， 
每 个 地 方 都 要 修改 。 
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2. 代理 模式 
代理 模式 又 分 为 动态 代理 模式 和 静态 代理 模式 。 


(1) 静态 代理 
静态 代理 关键 是 在 代理 对 象 和 目标 对 象 实现 共同 的 接口 ,并 且 代 理 对 象 持 有 目标 对 象 的 引 
用 。 这 里 用 类 ProxyServiceA 来 实现 IService 接口 ， 同 时 将 实现 IService 接口 的 对 象 作为 一 个 
属性 。 


Package AOP; 


Public class ProxyServiceA implements IService { 


public ProxyServiceA(IService service) { 
super (); 
this.service = service; 

} 


private IService service; 


public void service(String name) throws Exception { 
System.out.println("log start"); 
try{ 
service.service (name) ; 
} 
catch (Exception e) 
{ 
throw e; 
) 
System.out.println("log end"); 
) 


public static void main(String[] args) throws Exception ( 
IService service-new ServicelImplA(); 
Service -new ProxyServiceA(service); 
service.service("CYW"); 


H 
输出 结果 : 


log start 

ServiceImplA service:CYW 

log end 

有 了 ProxyServiceA 之 后 ， 打 印 日 志和 增加 try-catch 只 需 放 在 ProxyServiceA 类 里 面 ， 便 
于 后 续 修改 ， 比 如 现在 打印 日 志 是 输出 在 操作 台 的 ， 哪 天 需要 输入 到 日 志文 件 时 也 只 需 修改 
ProxyServiceA 中 的 打印 操作 即 可 。 但 问题 来 了 : 项 目 中 的 接口 可 不 止 一 个 ， 可 能 会 有 很 多 ， 
而 且 每 个 接口 中 的 方法 也 会 有 好 多 ， 这 样 一 个 一 个 地 增加 也 是 问题 ， 于 是 有 了 动态 代理 。 
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(2) 动态 代理 
在 Java 的 动态 代理 机 制 中 ， 有 两 个 重要 的 类 或 接口 : 一 个 是 InvocationHandler(Interface)， 
另 一 个 是 Proxy(Class)。 这 一 个 类 和 接口 是 实现 动态 代理 所 必须 用 到 的 。 


package AOP; 


import java.lang.reflect.InvocationHandler; 
import java.lang.reflect.Method; 
import java.lang.reflect.Proxy; 


public class DynaProxyServiceA implements InvocationHandler { 
private Object target;// 目 标 对 象 


public Object bind(Object object) { 
this.target = object; 
// 生 成 动态 代理 对 象 
Object obj-Proxy.newProxyInstance(this.target.getClass(). 
getClassLoader(), this.target.getClass().getInterfaces(), this); 
return obj; 
) 


public Object invoke (Object proxy, Method method, Object[] args) throws 
Throwable ( 


Object result - null; 
System. out.printin("method:"+method) ; 
System. out.println("args:"+args) ; 


System. out.println("target:"+this.target) ; 
System.out.println("log start"); 
tryí 
result - method.invoke(this.target, args); 
) 
catch(Exception e) 
{ 
throw e; 
} 
System.out.println("log end"); 
return result; 
} 


public static void main(String[] args) throws Exception { 
IService service = (IService) new DynaProxyServiceA() .bind (new 
ServiceImplA()); 


service.service("CYW"); 
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输出 结果 : 


method:public abstract void AOP.IService.service(java.lang.String) throws java.lang.Exception 
args:[Ljava.lang.Object;@1b6d3586 

target: AOP.ServiceImp1A@4554617c 

log start 

ServiceImplA service:CYW 

log end 


method:public abstract void AOP.IService.service(java.lang.String) throws 


java.lang.Exception 
args:[Ljava.lang.Object; @1b6d3586 
target :AOP.ServiceImp1A@4554617c 
log start 


ServiceImplA service:CYW 
log end 


通过 Proxy.newProxyInstance() 生 成 的 动态 代理 对 象 A 都 会 与 实现 InvocationHandler 接口 
的 对 象 B 关联 ， 动 态 代理 对 象 A 调用 目标 对 象 方法 时 都 会 变 成 调用 B 中 的 invoke 方法 。 在 
invoke 方法 中 织 入 增强 处 理 ， 并 通过 反射 回调 目标 对 象 方法 。 在 本 例 中 ， 通 过 bind ^E X Fb 
对 象 ServiceImplA 的 动态 代理 对 象 A，A 关联 了 实现 InvocationHandler 接口 对 象 的 
DynaProxyServiceA， 当 动态 代理 对 象 A 调用 目标 对 象 方法 时 会 执行 DynaProxyServiceA 的 
invoke 方法 ， 增 加 try-catch、 打 印 日 志 ， 并 回调 目标 对 象 的 方法 。 

与 前 面 的 静态 代理 比较 发 现 , 动态 代理 不 用 再 为 每 个 接口 手动 创建 代理 类 , 其 他 对 象 只 要 
与 InvocationHandler 接口 对 象 bbnd， 就 能 获得 该 InvocationHandler 接口 对 象 的 织 入 增强 。 


2.5. We 


我 们 回顾 一 下 这 一 章节 的 主要 内 容 , 主要 了 解 了 Spring HEAR, 学习 了 IOC. AOP. YE Spring 
框架 部 分 ， 了 解 了 框架 的 来 源 、 七 大 模块 。 在 IOC 部 分 ， 介 绍 了 依赖 注入 、 控 制 反 转 以 及 两 
者 的 区 别 ， 以 人 与 空气 为 例 ， 使 用 Spring 框架 演示 什么 是 依赖 注入 ， 也 对 Spring 有 一 个 大 概 
的 认识 。 在 AOP 部 分 ， 主 要 介绍 了 横 切 和 纵 切 的 概念 、AOP 的 概念 ， 并 通过 实例 来 了 解 AOP 
的 原理 。 
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在 上 一 章节 中 , 我 们 大 致 了 解 了 Spring 框架 , 并 学 习 了 控制 反 转 (IOC) 和 面向 切面 编程 (AOP) 
两 个 重要 的 编程 思想 ， 这 一 章 我 们 将 开始 学 习 Spring 框架 中 的 核心 容器 。 


本 章 主要 涉及 的 知识 点 : 


IOC 容器 : 容器 概念 、BeanFactory、ApplicationContext。 
beans 的 配置 : 三 种 配置 方式 。 

bean 的 注入 : 三 种 注入 方式 以 及 常见 数据 类 型 注入 介绍 。 
bean 的 生命 周期 和 五 大 作用 域 。 


为 了 能 深入 理解 Spring 框架 , 本 章 主 要 使 用 XML 的 方式 来 说 明 Spring 框架 的 使 用 , 虽然 | 


现在 提倡 使 用 注解 方式 配置 ， 简 单一 些 ， 但 是 为 了 更 好 、 更 深入 地 理解 ， 这 里 还 是 建议 要 
学 习 一 下 XML 的 配置 方式 。 


3.1 ioc 容器 


在 第 2 章 中 介绍 什么 是 依赖 注入 时 有 提 到 : 依赖 注入 是 组 件 之 间 的 依赖 关系 由 容器 在 运行 
期 决定 的 ， 即 由 容器 动态 地 将 某 个 依赖 关系 注入 组 件 之 中 。 那 什么 是 容器 呢 ? 既然 Spring 框 
架 实现 了 IOC, WA Spring 中 的 容器 是 什么 呢 ? 


3.1.1 容器 介绍 


在 日 常生 活 中 ， 容 器 是 指 用 以 容纳 物料 并 以 壳 体 为 主 的 基本 装置 ， 是 用 来 盛 放 东西 的 。 在 
编程 中 , 容器 是 用 来 存储 和 组 织 其 他 对 象 的 对 象 , 首先 要 确定 容器 也 是 对 象 , 也 可 以 当 作 bean， 
只 是 这 个 对 象 是 用 来 存储 和 组 织 其 他 对 象 的 , 那 其 他 对 象 是 什么 呢 ?其 他 对 象 其 实 就 是 bean 对 
象 ， 这 也 是 面向 对 象 编程 的 一 种 体现 ， 万 物 皆 对 象 。Spring 提供 了 BeanFactory、 
ApplicationContext 两 个 IOC 容器 来 管理 众多 的 bean 对 象 。 


3.1.2 BeanFactory 
一 提 到 工厂 ， 我 们 可 能 就 会 想到 富 某 康 。 工 厂 是 一 类 用 以 生产 货物 的 大 型 工业 建筑 物 。 


BeanFactory 不 是 用 来 生产 货物 的 ， 而 是 用 来 生产 管理 bean [f]. BeanFactory 会 在 bean 生命 周 
期 的 各 个 阶段 中 对 bean 进行 管理 ， 并 且 Spring 将 这 些 阶段 通过 各 种 接口 暴露 给 我 们 ， 让 我 们 
可 以 对 bean 进行 各 种 处 理 。 我 们 只 要 让 bean 实现 对 应 的 接口 ， 那 么 Spring 就 会 在 bean 的 生 
命 周期 调用 我 们 实现 的 接口 来 处 理 该 bean。 这 是 怎么 实现 的 呢 ? 主要 分 为 以 下 两 个 阶段 。 


1. bean 容器 的 启动 


工厂 要 生产 货物 ， 首 先 得 把 工厂 运转 起 来 。 同 样 ，bean 容器 要 管理 bean， 也 需要 先 把 容 
器 启动 起 来 ， 获 取 到 bean 的 定义 信息 之 后 才能 管理 


(1) 读 取 bean 的 xml 配置 文件 ， 然 后 将 xml 中 每 个 bean 元 素 分 别 转换 成 BeanDefinition 
对 象 。 


public abstract class AbstractBeanDefinition extends 
BeanMetadataAttributeAccessor 

implements BeanDefinition, Cloneable { 

private volatile Object beanClass; 

private String scope = SCOPE_DEFAULT; 

private boolean abstractFlag = false; 

private boolean lazyInit = false; 

private int autowireMode = AUTOWIRE_NO; 

private int dependencyCheck = DEPENDENCY_CHECK_NONE; 

private String[] dependsOn; 

private ConstructorArgumentValues constructorArgumentValues; 

private MutablePropertyValues propertyValues; 

private String factoryBeanName; 

private String factoryMethodName; 

private String initMethodName; 

private String destroyMethodName; 


BeanClass 保存 bean 的 class 属性 ，scope 保存 Bean 的 作用 域 ，abstractFlag 保存 该 bean 
是 否 抽象 ，lazyInit 保存 是 否 延迟 初始 化 ，autowireMode 保存 是 否 自动 装配 ，dependencyCheck 
保存 是 否 坚 持 依赖 ，dependsOn 保存 该 bean 依赖 于 哪些 bean (这 些 bean 必须 提取 初始 化 ) ， 
constructorArgumentValues 保存 通过 构造 函数 注入 的 依赖 ，propertyValues 保存 通过 setter 方法 
注入 的 依赖 , factoryBeanName fill factoryMethodName 用 于 factorybean, 也 就 是 工厂 类 型 的 bean, 
initMethodName 和 destroyMethodName 分 别 对 应 bean 的 init-method 和 destroy-method 属性 。 
后 面 会 对 这 些 内 容 进 行 详细 介绍 。 

(2) 通过 BeanDefinitionRegistry 将 bean 注册 到 beanFactory 中 。 

上 面 获取 到 bean 的 信息 之 后 ， 是 怎么 注册 到 BeanFactory 中 的 呢 ?” 其 实 是 通过 
BeanDefinitionRegistry 将 bean 注册 到 beanFactory 中 的 ， 因 为 BeanFactory 的 实现 类 需要 实现 
BeanDefinitionRegistry 接口 。 

Public interface BeanDefinitionRegistry extends AliasRegistry { 


void registerBeanDefinition(String beanName, BeanDefinition 
beanDefinition) throws BeanDefinitionStoreException; 
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void removeBeanDefinition(String beanName) throws 
NoSuchBeanDefinitionException; 


BeanDefinition getBeanDefinition(String beanName) throws 
NoSuchBeanDefinitionException; 

boolean containsBeanDefinition (String beanName) ; 

String[] getBeanDefinitionNames () ; 

int getBeanDefinitionCount (); 

boolean isBeanNameInUse (String beanName) ; 


) 


BeanDefinitionRegistry 接口 提供 了 根据 beanName 注册 对 应 beanDefinition 的 方法 。 在 


DefaultListableBeanFactory 类 中 实现 了 该 方法 ， 并 将 beanDefinition 保存 在 了 ConcurrentHash- 
Map 中 。 


@SuppressWarnings ("serial") 
public class DefaultListableBeanFactory extends 
AbstractAutowireCapableBeanFactory 
implements ConfigurableListableBeanFactory, BeanDefinitionRegistry, 
Serializable { 
/** Map of bean definition objects, keyed by bean name */ 


private final Map<String, BeanDefinition> beanDefinitionMap = new 
ConcurrentHashMap<String, BeanDefinition»(64); 


GOverride 


public void registerBeanDefinition(String beanName, BeanDefinition 
beanDefinition) 


throws BeanDefinitionStoreException ( 
LE sas wra 


this.beanDefinitionMap.put (beanName, beanDefinition); 
} 


Fb, Spring 还 对 外 暴露 了 一 些 接口 来 对 bean 初始 化 ， 例 如 BeanFactoryPostProcessor. 


Public interface BeanFactoryPostProcessor { 
[** 


* Modify the application context's internal bean factory after its 
standard 
initialization. All bean definitions will have been loaded, but no beans 
will have been instantiated yet. This allows for overriding or adding 
properties even to eager-initializing beans. 
* @param beanFactory the bean factory used by the application context 


* @throws org.springframework.beans.BeansException in case of errors 


*/ 


void postProcessBeanFactory (ConfigurableListableBeanFactory 
beanFactory) throws BeansException; 


) 
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我 们 可 以 翻译 一 下 postProcessBeanFactory 的 注释 信息 。postProcessBeanFactory 可 以 修改 
应 用 上 下 文中 已 经 进行 standard 初始 化 的 beanFactory， 此 时 所 有 bean 的 定义 信息 已 经 加 载 完 
成 ， 但 还 未 实例 化 ， 允 许 覆 盖 、 新 增 甚 至 重新 初始 化 bean 信息 ， 一 个 典型 的 例子 就 是 属性 履 
盖 器 PropertyOverrideConfigurer。 对 于 一 些 参数 ,可 以 配置 在 properties 中 ,而 不 用 配置 在 Spring 
的 XML 配置 文件 中 。 


2. bean 容器 的 实例 化 


上 面 把 bean 容器 启动 之 后 ， 工 厂 算是 运转 起 来 了 ， 配 方 (beanDefinition〉 也 已 经 准备 充 
分 ， 然 后 就 是 生产 〈 实 例 化 ) 、 管 理 货物 (bean) 了 。 实 例 化 bean 主要 通过 反射 和 CGLIB 两 
种 方式 ， 在 bean 的 实例 化 过 程 中 ，Spring 也 暴露 了 一 些 接口 ， 如 表 3-1 所 示 。 


表 3-1 在 bean 的 实例 化 过 程 中 Spring 暴露 的 一 些 接口 


ere eT 


en 
InitializingBean bean 实 例 化 、 所 有 属性 设置 后 调用 初始 化 方法 
DisposableBean 在 bean 丢 弃 的 时 候 调 用 销毁 方法 
我 们 可 以 通过 示例 演示 一 下 这 几 个 接口 的 使 用 。 
(1) 创建 Maven project， 在 pom.xml 中 引入 spring-core、spring-context。 


<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
<modelVersion>4.0.0</modelVersion> 


<groupId>com. demo</groupId> 
<artifactId>BeanFactoryDemo</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>jar</packaging> 


<name>BeanFactoryDemo</name> 
<url>http://maven.apache.org</url> 
<properties> 
<project .build.sourceEncoding>UTF-8</project .build. sourceEncoding> 
<spring.version>5.0.0.RELEASE</spring.version> 
</properties> 
<dependencies> 
<dependency> 
<groupId>org. springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>${spring.version}</version> 
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</dependency> 
<dependency> 
<groupId>org. springframework</groupId> 
<artifactId>spring-context</artifactId> 
<version>${spring.version}</version> 
</dependency> 
<dependency> 
XgroupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
</project> 


(2) 创建 bean 对象， 实现 上 面 列 出 的 接口 。 


package com.demo.model; 


import org.springframework.beans.BeansException; 

import org.springframework.beans.factory.BeanFactory; 
import org.springframework.beans.factory.BeanFactoryAware; 
import org.springframework.beans.factory.BeanNameAware; 
import org.springframework.beans.factory.DisposableBean; 
import org.springframework.beans.factory.InitializingBean; 


public class UserBean implements BeanNameAware,BeanFactoryAware, 
InitializingBean,DisposableBean ( 


public void setBeanName(String name) ( 


System.out.println (name); 


public void setBeanFactory(BeanFactory beanFactory) throws 
BeansException ( 
System.out.println (beanFactory); 


public void afterPropertiesSet() throws Exception { 
System.out.println("InitializingBean"); 


public void destroy() throws Exception ( 
System.out.println("DisposableBean"); 
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(3) bean 配置 。 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http: //www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 
<bean id-"user" class="com.demo.model.UserBean"></bean> 
</beans> 


(4) 测试 。 
使 用 ApplicationContext 获取 BeanFactory， 再 通过 getBean 方法 获取 对 应 的 bean， 最 后 调 
用 destroy 方法 进行 销毁 ， 从 输出 结果 可 以 看 到 依次 调用 了 BeanNameA ware 、 
BeanFactoryAware, InitializingBean, DisposableBean 接口 。 
public static void main( String[] args ) throws Exception 
{ 
ApplicationContext context=new ClassPathXmlApplicationContext (new 
String[]("applicationContext.xml"]); 
BeanFactory factory-context; 
UserBean user=(UserBean) factory.getBean ("user"); 


user.destroy(); 


) 
输出 结果 : 


user 


org.springframework.beans.factory.support.DefaultListableBeanFactory@6bf 
256fa: defining beans [user]; root of factory hierarchy 
InitializingBean 


DisposableBean 


user 

org. springframework.beans. factory. support .DefaultListableBeanFactory@6bf256fa: defining beans [user]; root of factory hierarchy 
InitializingBean 

DisposableBean| 


3.1.3 ApplicationContext 


在 上 面 的 示例 中 , f: HH ApplicationContext 3&4 f bean 的 配置 ,然后 直接 将 ApplicationContext 
接口 对 象 赋值 给 了 BeanFactory 接口 对 象 ， 为 什么 可 以 赋值 呢 ? 其 实 ApplicationContext 接口 实 
现 了 BeanFactory 接口 。 


public interface ApplicationContext extends EnvironmentCapable, 
ListableBeanFactory, HierarchicalBeanFactory,MessageSource, 
ApplicationEventPublisher, ResourcePatternResolver 


从 上 面 ApplicationContext 接口 的 继承 关系 可 以 看 到 ， 它 还 通过 继承 其 他 接口 扩展 了 
BeanFactory 的 功能 。 


*  MessageSource: 为 应 用 提供 国际 化 访问 功能 。 
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e  ResourcePattern Resolver: 提供 资源 (4e URL 和 文件 系统 ) 的 访问 支持 。 
e  ApplicationEventPublisher: 引入 事件 机 制 ， 包 括 启动 事件 、 关 闭 事 件 等 ， 让 容器 在 上 下 文 
中 提供 了 对 应 用 事件 的 支持 。 它 代表 的 是 一 个 应 用 的 上 下 文 环境 。 
BeanFactory 主要 是 面 对 Spring 框架 的 基础 设施 ， 面 对 Spring 自己 。Applicationcontext 主 
要 面 对 于 Spring 使 用 的 开发 者 。 开 发 者 基本 都 会 使 用 Applicationcontext， 而 非 BeanFactory, 
所 以 在 上 面 实例 中 使 用 ApplicationContext 获取 BeanFactory 接口 对 象 。 
上 面 的 ApplicationContext 对 象 是 通过 ClassPathXmlApplicationContext 方法 获取 的 ， 还 有 
一 种 获取 方式 ， 即 使 用 FileSystemXmlApplicationContext 方法 获取 。 
e ClassPathXmlApplicationContext 表示 从 类 路 径 下 加 载 配置 文件 。 文 件 路 径 默认 指 的 是 项 目 
的 classpath 路 径 下 , 所 以 不 需要 写 前 级 “classpath:”, 如 果 指 向 绝对 路 径 , 需要 加 上 “file:”。 
new ClassPathXmlApplicationContext (new String[] 
("ApplicationContext.xml"])); 
*  FileSystemXmlApplicationContext 表示 从 文件 系统 中 加 载 配置 文件 。 文 件 路 径 默认 指 的 是 
项 目的 根 目 录 下 ， 若 想 使 用 项 目的 classpath 路 径 ， 则 需要 加 上 “classpath:”。 


new FileSystemXmlApplicationContext (new String[]{"classpath: 
ApplicationContext.xml"]); 


Bean 的 配置 


在 上 一 小 节 中 为 了 演示 容器 Bean 实例 化 时 暴露 出 的 几 个 接口 ， 将 UserBean 配置 在 XML 
中 ， 其 实 常 见 的 Bean 配置 有 3 种 : 基于 XML 配置 Bean， 使 用 注解 定义 Bean， 基 于 Java 类 
提供 Bean 定义 。 
3.2.1 基于 XML 配置 Bean 


基于 XML 配置 Bean 时 , Spring 通过 <bean> 配 置 来 实例 化 ` 设 置 bean 的 属性 以 及 设置 bean 
间 的 相互 依赖 性 。 一 个 <bean> 通 常 需要 定义 id 和 class 属性 。class 属性 是 必需 的 ， 不 然 Spring 
怎么 知道 是 哪个 呢 。id 不 是 必需 的 ， 不 过 如 果 配 置 文件 中 配置 的 其 他 bean 要 引用 该 bean， 那 
么 id 也 是 必需 的 ， 通 常 都 加 上 。 


<bean id-"user" class="com.demo.model.UserBean"></bean> 


3.2.2 ”使 用 注解 定义 Bean 


如 果 采 用 基于 XML 的 配置 ，bean 定义 信息 和 bean 实现 类 本 身 是 分 离 的， 而 采用 基于 注 
解 的 配置 方式 时 , bean 定义 信息 即 通过 在 bean 实现 类 上 标注 注解 实现 。 在 第 2 章 中 , 定义 Air 
和 Person 时 都 使 用 了 @Component 来 注解 bean. 
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package com.demo.model; 
import org.springframework.stereotype.Component; 


GComponent 

public class CleanAir implements IAir ( 
GOverride 
public String toString() ( 


return "CleanAir"; 


) 


我 们 使 用 @Component 注解 在 CleanAir 类 声明 处 对 类 进行 标注 ， 它 可 以 被 Spring 容器 识 
别 ， 自 动 将 POJO 转换 为 容器 管理 的 bean 。 它 和 <bean id-"CleanAir" 
class="com.demo.model.CleanAir"></bean> 是 等 效 的 。 除了 @Component 以 外 ，Spring 提供 了 以 
下 3 个 功能 基本 和 @Component 等 效 的 注解 , 分 别 用 于 对 DAO, Service 及 Web 层 的 Controller 
进行 注解 ， 所 以 也 称 这 些 注解 为 Bean 的 衍 型 注解 : 

e @Repository: 用 于 对 DAO 实现 类 进行 标注 。 

* (Service: 用 于 对 Service 实现 类 进行 标注 。 

* @Controller: 用 于 对 Controller 实现 类 进行 标注 。 


那 问 题 来 了 : 既然 都 是 bean， 为 什么 还 提供 4 个 呢 ? 因为 这 样 能 让 注解 的 用 途 更 加 清晰 ， 
而 且 不 同 的 注解 也 有 各 自 特殊 的 功能 。 


3.2.3 ”基于 Java 类 提供 Bean 定义 


在 普通 的 POJO 类 中 只 要 标注 @Configuration 注解 ， 就 可 以 为 Spring 容器 提供 bean 定义 
的 信息 了 。 每 个 标注 了 @Bean 的 类 方法 都 相当 于 提供 了 一 个 bean 的 定义 信息 。 


package com.demo.model; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
public class AppConf { 


@Bean 

public CleanAir cleanAir() { 
return new CleanAir(); 

} 

@Bean 

public DirtyAir dirtyAir()( 
return new DirtyAir(); 


) 
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@Bean 
public Person person() { 
return new Person(dirtyAir()); 
} 
) 
我 们 只 需 在 XML 中 配置 开启 context 扫描 即 可 实现 bean 的 配置 ， 省 去 了 配置 Person, 
DirtyAir。 
<context:component-scan base-package-"com.demo.model"/» 
<bean id="conf" class-"com.demo.model.AppConf"/» 
ApplicationContext context=new ClassPathXmlApplicationContext (new 
String[] {"ApplicationContext.xml"}); 
BeanFactory factory=context; 
AppConf conf=(AppConf) factory.getBean ("conf") ; 
conf.person().Breath(); 


DirtyAir 


基于 Java 类 的 配置 方式 和 基于 XML 或 基于 注解 的 配置 方式 相 比 , 前 者 通过 代码 的 方式 更 
加 灵活 地 实现 了 Bean 的 实例 化 及 Bean 之 间 的 装配 ， 后 面 两 者 是 通过 配置 声明 的 方式 实现 的 ， 
在 灵活 性 上 要 稍 逊 一 些 ， 但 是 配置 上 要 更 简单 一 些 。 


本 . Bean 的 注入 


在 Bean 的 配置 中 介绍 的 是 Bean 的 声明 问题 ， 即 在 哪 声明 、 怎 么 声明 的 问题 。 本 节 将 要 
讲解 的 Bean 的 注入 是 怎么 实例 化 、 怎 么 注入 的 问题 。Bean 注入 的 方式 有 两 种 : 一 种 是 在 XML 
中 配置 ， 另 一 种 是 使 用 注解 的 方式 注入 。 


3.3.1 XML 方式 注入 

XML 方式 注入 一 般 有 三 种 方式 : 属性 注入 、 构 造 函数 注入 和 工厂 方法 注入 。 

1. 属性 注入 

在 传统 的 对 象 实例 化 时 可 以 先 使 用 new class(), 然后 通过 setXXX0 方 法 设置 对 象 的 属性 值 
或 依赖 对 象 ， 属 性 注入 也 是 采用 这 种 方式 ， 只 是 Spring 框架 会 在 内 部 完成 这 些 操作 ， 它 会 先 
调用 Bean 的 默认 构造 函数 实例 化 Bean 对 象 , 然后 通过 反射 的 方式 调用 Setter 方 法 注入 属性 值 。 
它 会 使 用 默认 的 构造 函数 〈 无 参数 构造 函数 ) ， 只 需 为 注入 的 属性 设置 set 方法 ， 可 选择 性 和 
灵活 性 比较 高 ， 所 以 也 是 比较 常用 的 一 种 注入 方式 。 这 里 还 是 在 IOC 章节 人 和 空气 的 基础 上 
稍 作 修改 来 演示 。IAir 接口 和 CleanAir、DirtyAir 类 不 变 ， 这 里 就 不 贴 了 。 
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(1) #3 XMLInstance X 


package com.demo.model; 
public class XMLInstance{ 
private String name; 


public void setName(String name) { 
this.name = name; 

H 

private IAir air; 


public void setAir(IAir air) ( 
this.air - air; 
) 
public void Breath() 
{ 
System. out.println("Name:"+this.name+";Air:"+this.air.toString()); 
} 
} 


在 XMLInstance 类 中 并 未 声明 构造 函数 ， 对 于 air 属性 只 设置 了 set 方法 ，get 方法 也 没 
设置 。 
<bean id="CleanAir" class="com.demo.model.CleanAir"> 
<qualifier value="cleanair"/> 
</bean> 
<bean id="xmlinstance" class="com.demo.model.XMLInstance"> 
<property name-"air" ref="CleanAir"></property> 
<property name="name" value="abc"></property> 
</bean> 


在 XML 中 使 用 property 类 配置 属性 ，name 表示 属性 名 ，value 用 来 设置 基本 数据 类 型 的 
属性 值 。 在 Spring 配置 文件 中 ，bean 之 间 可 以 相互 引用 ， 引 用 时 可 以 用 <re 他 标签 配置 bean 
的 id 属性 。<re 人 > 可 以 用 在 <property> 属 性 中 , 也 可 以 用 在 <construct-arg> 构 造 函 数 的 参数 值 中 ， 
还 可 以 用 在 其 他 地 方 ， 通 过 引用 能 减少 bean 的 声明 。 

2. 构造 函数 注入 

在 属性 注入 时 先 使 用 默认 的 构造 函数 〈 无 参数 构造 函数 ) 实例 化 ， 然 后 通过 set 方法 注入 
属性 , 在 传统 实例 化 对 象 时 可 以 自 定义 构造 函数 进行 实例 化 。 构 造 函 数 注入 就 是 通过 自 定 义 构 
造 函 数 来 进行 对 象 的 实例 化 。 这 里 在 XMLInstance 类 的 基础 上 增加 了 一 个 构造 函数 ， 第 一 个 
参数 是 String 类 型 的 name， 第 二 个 参数 是 IAir 类 型 的 air。 

Public XMLInstance (String name, IAir air) { 


super (); 
this.name = name; 
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this.air = air; 
H 
在 XML 中 ， 使 用 <construectrarg> 来 设置 构造 函数 的 参数 ，index 属性 设置 参数 的 顺序 ， 
参数 顺序 应 该 与 构造 函数 一 致 ，ref 设置 引用 bean 的 id. value 设置 构造 函数 参数 的 值 。 
<bean id="xmlcontructinstance" class="com.demo.model.XMLInstance"> 
<constructor-arg index="1" ref="CleanAir"></constructor-arg> 


<constructor-arg index="0" value="abc"></constructor-arg> 
</bean> 


3. 工厂 方法 注入 


工厂 方法 注入 参考 的 是 工厂 设计 模式 , 在 工厂 类 中 实现 对 象 的 实例 化 。 工 厂 类 负责 创建 一 
个 或 多 个 目标 类 实例 , 一 般 以 接口 或 抽象 类 变量 的 形式 返回 目标 类 实例 。 工 厂 类 对 外 屏蔽 了 目 
标 类 的 实例 化 步骤 , 调用 者 甚至 不 用 知道 具体 的 目标 类 是 什么 。 工厂 方法 也 分 静态 工厂 方法 和 
非 静态 工厂 方法 。 静 态 工厂 方法 不 用 实例 化 工厂 类 , 直接 通过 类 名 调用 。 非 静态 工厂 方法 需要 
先 实例 化 工厂 类 ， 然 后 通过 工厂 类 对 象 调用 获取 对 象 。 这 里 创建 了 一 个 工厂 类 XMLFactory, 
在 类 中 定义 了 一 个 静态 方法 和 一 个 实例 方法 (用 来 实例 化 bean AR)» 


package com.demo.model; 
public class XMLFactory { 


public XMLInstance CreateInstance() 
{ 

return new XMLInstance("instance",new CleanAir()); 
) 


public static XMLInstance CreateStaticInstance() 
{ 
return new XMLInstance("static instance",new CleanAir()); 
} 
} 
(1) 静态 工厂 方法 
只 需 设置 工厂 方法 对 应 的 类 ， 以 及 对 应 的 工厂 方法 。 
<bean id-"xmlfactorystaticinstance" class="com.demo.model.XMLFactory" 
factory-method="CreateStaticInstance"></bean> 
(2) 实例 工厂 方法 
需要 先 实例 化 工厂 类 ， 再 通过 工厂 类 对 象 调用 实例 方法 获取 bean 对 象 。 
<bean id="xmlfactory" class="com.demo.model.XMLFactory"></bean> 


<bean id-"xmlfactoryinstance" factory-bean-"xmlfactory" 
factory-method- "CreateInstance"»«/bean» 
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4. 常见 数据 类 型 注入 

(1) List 属性 注入 

使 用 <list> 配 置 java.util.List 类 型 的 属性 。List 属性 中 的 元 素 可 以 是 任何 数据 类 型 的 值 ， 如 
果 是 Java 对 象 ， 可 以 使 用 ref 指定 ， 或 使 用 <bean> 定 义 新 实例 。 如 果 是 基础 数据 类 型 ， 可 直接 
使 用 字符 串 。<list> 中 的 元 素 会 按 配置 的 先后 顺序 排序 。 


<property name="lists"> 
<list> 
<value>1</value> 
<ref bean="CleanAir" /> 
<bean class="com.demo.model.CleanAir"/> 
</list> 
</property> 


(2) Set 属性 注入 

使 用 <set> 配 置 java.util.Set 类 型 的 属性 。Set 属性 中 的 元 素 可 以 是 任何 数据 类 型 的 值 ， 如 
果 是 Java 对 象 ， 可 以 使 用 ref 指定 ， 或 使 用 <bean> 定 义 新 实例 。 如 果 是 基础 数据 类 型 ， 可 直接 
使 用 字符 串 。<set> 中 的 元 素 没有 先后 顺序 。 


</property> 
<property name="sets"> 
<set> 
<value>1</value> 
<ref bean="CleanAir" /> 
<bean class="com.demo.model.CleanAir"/> 
</set> 
</property> 


(3) Map 属性 注入 
使 用 <map> 配 置 java.util. Map 类 型 的 属性 .<entry> 配 置 Map 里 的 元 素 , key 指定 索引 ,value 
指定 值 。 如 果 是 Java 对 象 ， 可 以 使 用 ref 指定 ， 或 使 用 <bean> 定 义 新 实例 。 


<property name="maps"> 
<map> 
<entry key-"keyl" value="1"></entry> 
<entry key-"key2" value-ref="CleanAir"></entry> 
<entry key="key3" > 
<bean class="com.demo.model.CleanAir"/> 
</entry> 
</map> 
</property> 


(4) Properties 属性 注入 
fi Fl «props? Ri E java.util. Properties 类 型 的 属性 。<props> 配 置 一 个 Properties 对 象 , <prop> 
配置 一 条 属性 ， 属 性 key 配置 索引 。 
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<property name="pros"> 
<props> 
<prop key="prokeyl">prokeyA</prop> 
<prop key="prokey2">prokeyB</prop> 
</props> 
</property> 


(5) 自 定义 属性 编辑 器 
有 一 些 属 性 是 没 法 注入 的 ， 此 时 就 需要 自 定 义 ， 比 如 日 期 类 型 。 可 以 通过 继承 
PropertyEditorSupport 的 类 ， 重 写 setAsText 方法 来 实现 注入 。 这 里 定义 了 CustomerProperty 继 
承 PropertyEditorSupport， 重 写 了 setAsText 方法 ， 并 将 该 bean 配置 到 XML 中 。 


package com.demo.model; 


import java.beans.PropertyEditorSupport; 
import java.text.ParseException; 
import java.text.SimpleDateFormat; 


public class CustomerProperty extends PropertyEditorSupport { 
private String format="yyyy-MM-dd"; 
public String getFormat() { 
return format; 
} 
public void setFormat (String format) { 
this.format = format; 
I 
GOverride 
public void setAsText(String text) throws IllegalArgumentException ( 


SimpleDateFormatsdf-new SimpleDateFormat (format); 
//super.setAsText (text) ; 
try ( 
// 转 换 对 象 ， 通 过 setvalue 方法 重新 赋值 
this.setValue(sdf.parse(text)); 
) catch (ParseException e) { 
e.printStackTrace(); 


} 
<bean id="customEditorConfigurer" class="org.springframework.beans. 
factory.config.CustomEditorConfigurer"> 
<property name="customEditors"> 
<map> 
«entry key-"java.util.Date" value="com.demo.model. 

CustomerProperty"/» 

</map> 

</property> 
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</bean> 


配置 之 后 就 可 以 注入 Date 类 型 的 属性 了 。 


<property name-"date" value-"2018-8-20"/» 


新 建 XmlCollectionsDemo 类 ， 配 置 上 面 几 个 类 型 的 属性 来 演示 。 


package com.demo.model; 


import 
import 
import 
import 
import 


import 
import 
import 


java.util.Date; 
java.util.List; 
java.util.Map; 
java.util.Properties; 
java.util.Set; 


org.springframework.beans.factory.BeanFactory; 
org.springframework.context.ApplicationContext; 


org.springframework.context.support.ClassPathXmlApplicationContext; 


public 


class XmlCollectionsDemo ( 


private List«Object» list; 


private Properties pros; 


private Set<Object> sets; 


private Map<String,Object> maps; 


private Date date; 


public Date getDate() ( 
return date; 


public void setDate(Date date) ( 
this.date - date; 


public List<Object> list() { 
return list; 


public void setLists(List<Object> list) 
this.list - list; 
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public Properties getPros() { 
return pros; 


public void setPros(Properties pros) { 
this.pros = pros; 


public Set<Object> getSets() { 
return sets; 


public void setSets(Set«Object» sets) { 
this.sets = sets; 


public Map<String, Object> getMaps() { 
return maps; 


public void setMaps(Map<String, Object» maps) { 
this.maps = maps; 


public static void main( String[] args ) throws Exception 
i 


ApplicationContext context=new ClassPathXmlApplicationContext (new 


String[]("ApplicationContext.xml"]); 


BeanFactory factory-context; 
XmlCollectionsDemo annontationInstance- (XmlCollectionsDemo) 


factory.getBean ("xmlCollectionsDemo") ; 
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System. out.printin(annontationInstance. list); 
System. out.printin (annontationInstance.pros) ; 
System. out.printin (annontationInstance.sets) ; 
System. out.println(annontationInstance.maps) ; 
System. out.printin(annontationInstance.date) ; 


H 
下 面 是 属性 对 应 的 XML 配置 文件 。 


<bean id-"xmlCollectionsDemo" class="com.demo.model.Xm1CollectionsDemo"> 
<property name="lists"> 
<list> 
<value>1</value> 


<ref bean="CleanAir" /> 
<bean class-"com.demo.model.CleanAir"/» 
</list> 
</property> 
<property name="sets"> 
<set> 
«value»1«/value» 
«ref bean-"CleanAir" /» 
Xbean class-"com.demo.model.CleanAir"/» 
</set> 
</property> 
<property name="maps"> 
<map> 
<entry key="keyl" value="1"></entry> 
<entry key="key2" value-ref="CleanAir"></entry> 
<entry key="key3" > 
<bean class="com.demo.model.CleanAir"/> 
</entry> 
</map> 
</property> 
<property name="pros"> 
<props> 
<prop key-"prokeyl"»prokeyA«/prop» 
<prop key="prokey2">prokeyB</prop> 
</props> 
</property> 
<property name-"date" value-"2018-8-20"/» 
</bean> 


通过 运行 main 方法 ， 打 印 出 属性 值 : 


{1, CleanAir, CleanAir] 
{prokey2=prokeyB, prokeyl=prokeyA} 

{1, CleanAir, CleanAir] 

{keyl=1, key2=CleanAir, key3=CleanAir} 
Mon Aug 20 00:00:00 CST 2018 


5. 初始 化 函数 、 销 毁 函 数 


通过 上 面 几 种 注入 方式 的 学 习 ， 对 通过 XML 对 bean 实例 化 有 了 了 解 。 有 的 对 象 在 实例 
化 之 后 还 需要 执行 某 些 初始 化 代码 , 但 这 些 初 始 化 代码 还 不 能 写 在 构造 函数 中 , 此 时 可 以 将 初 
始 化 代码 写 到 某 个 方法 中 。 将 init-method 属性 值 设置 为 该 方法 ，Spring 会 强制 执行 该 方法 进 
行 初始 化 。 有 的 对 象 在 使 用 完毕 之 后 需要 释放 ， 可 以 使 用 destroy-method 来 进行 销毁 。 
public void DestoryMethod() 


t 
System.out.println("DestoryMethod"); 
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public void InitMethod() 
{ 

System. out.print1ln("InitMethod") ; 
H 


这 里 先 在 XMLInstance 类 中 增加 上 面 两 个 方法 来 模拟 销毁 和 初始 化 方法 ， 然 后 在 xml 配 


置 bean 时 设置 destroy-method, init-method 属性 值 对 应 两 个 方法 的 方法 名 。 注 解 中 的 
@PostConstruct 对 应 initmethod、@PreDestory 对 应 destroy-method. 


<bean id-"xmlfactoryinstance" factory-bean-"xmlfactory" factory-method= 


"CreateInstance" destroy-method-"DestoryMethod" init-method="InitMethod"> 
</bean> 


3.3.2 注解 方式 注入 


1. 常用 注解 介绍 
学 习 完 XML 注入 之 后 再 学 习 注解 方式 注入 就 容易 得 多 了 ， 注 解 方式 注入 主要 涉及 


@Autowired. (Resource. (Required. (Qualifier, @Value 这 几 个 注解 。 在 2.2.4 节 定义 Person 
时 就 使 用 过 @Autowired、@Qualifier。 下 面 来 了 解 一 下 它们 的 具体 用 法 。 


46 


© @Autowired: 默认 按 类 型 匹配 注入 bean， 可 以 对 类 成 员 变 量 、 方 法 及 构造 函数 进行 标注 ， 


完成 自动 装配 的 工作 。 在 使 用 @Autowired 时 ， 首 先 在 容器 中 查询 对 应 类 型 的 bean。 如 果 
查询 结果 刚好 为 一 个 ， 就 将 该 bean 装配 给 @Autowired 指定 的 数据 ; 如 果 查 询 的 结果 不 止 
一 个 ， 那 么 @Autowired 会 根据 名 称 来 查找 。 如 果 查询 的 结果 为 空 ， 那 么 会 抛 出 异常 。 解 
决 方法 时 ， 使 用 required=false。 


* @Required: 适用 于 bean 属性 setter 方法 ， 并 表示 受 影 响 的 bean 属性 必须 在 XML 配置 文 


件 在 配置 时 进行 填充 ; 否则 ， 容 器 会 抛 出 一 个 BeanInitializationException 异常 。 


© @Qualifier: @Autowired 默认 是 单 实例 的 ， 但 是 在 面向 接口 编程 中 ， 如 果 把 一 个 属性 设置 


为 接口 类 型 ， 一 个 接口 就 可 能 有 多 个 实现 ， 那 么 到 底 注 入 哪 一 个 呢 ?为 了 解决 这 个 问题 ， 
就 有 了 @Qualifier。 


e @Value: 在 xml 配 置 属性 时 可 以 通过 property 的 value 设置 默认 值 ，@Value 也 可 以 为 属 


性 设置 默认 值 。 


© = @Resource: 默认 按 名 称 匹 配 注 入 bean。 要 求 提供 一 个 bean 名 称 的 属性 ， 如 果 属 性 为 空 ， 


就 自动 采用 标注 处 的 变量 名 或 方法 名 作为 bean 的 名 称 。 如 果 我 们 没有 在 使 用 @Resource 
时 指定 bean 的 名 字 ， 同 时 Spring 容器 中 又 没有 该 名 字 的 bean， 这 时 (@Resource 就 会 退化 
为 @Autowired， 即 按照 类 型 注入 。 

GComponent 

public class AnnontationInstance ( 


GValue ("abc") 
private String name; 


public void setName(String name) ( 


this.name = name; 
H 


//@Resource 5ieAutowired 两 者 选 其 一 

// @Autowired 

// @Qualifier (value="cleanair") 

private IAir air; 

@Resource (name="CleanAir") 

public void setAir(IAir air) { 
this.air = air; 

} 


public void Breath() 


f 
System. out.printin("Name:"+this.name+";Air:"+this.air.toString()); 


j 
} 


在 上 面 的 代码 中 ， 使 用 @Value 注解 为 name 设置 了 默认 值 ， 使 用 @Resources 设置 bean 
的 名 称 为 IAir 属性 注入 bean， 也 可 以 使 用 @Autowired+@Qualifier 为 IAir 注入 bean. 


2. 开启 注解 


配置 完 注解 之 后 ， 还 要 告诉 Spring 开启 注解 ， 这 样 @Autowired、@Resources 这 些 注解 才 
起 作用 。 开 启 注解 有 两 种 比较 简单 的 方式 。 


(1) 在 xml 配置 文件 中 使 用 context:annotation-config: 


<context:annotation-config /> 


(2) 在 xml 配置 文件 中 使 用 context:component-scan: 


<context:component-scan base-package-"com.demo.model"/» 


在 3.1.2 节 容 器 启动 获得 BeanDefinition 对 象 中 有 一 个 scope 属性 。 该 属性 控制 着 bean 对 
象 的 作用 域 。 本 节 介 绍 Bean 的 作用 域 及 生命 周期 ， 了 解 bean 是 怎么 来 的 、 怎 么 没 的 。 
3.4.4. Bean 的 作用 域 


在 3.1.2 节 中 介绍 到 Bean 容器 启动 会 先 读 取 bean 的 xml 配置 文件 , 然后 将 xml 中 每 个 bean 
元 素 分 别 转换 成 BeanDefinition 对 象 。 在 BeanDefinition 对 象 中 有 scope 属性 ， 就 是 它 控制 着 
bean 的 作用 域 。 
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Spring 框架 支持 5 种 作用 域 ,有 3 种 作用 域 是 当 开 发 者 使 用 基于 Web 的 ApplicationContext 
时 才 生 效 的 。 表 3-2 给 出 了 Spring 直接 支持 的 作用 域 。 当 然 开 发 者 也 可 以 自己 定制 作用 域 。 


表 3-2 Spring 直接 支持 的 作用 域 


作 用 域 描 述 

单 例 (singleton ) 默认 ， 每 一 个 Spring IoC 容器 都 拥有 唯一 的 一 个 实例 对 象 

原型 (prototype) 一 个 Bean 定义 ， 任 意 多 个 对 象 

一 个 HTTP 请 求 会 产生 一 个 Bean 对 象 ， 也 就 是 说 ， 每 一 个 HTTP 请 求 都 有 自己 
的 Bean 实例 ， 只 在 基于 Web 的 Spring ApplicationContext 中 可 用 

限定 一 个 Bean 的 作用 域 为 HTTPSession 的 生命 周期 。 同 样 ， 只 有 基于 Web 的 
Spring ApplicationContext 才能 使 用 

限定 一 个 Bean 的 作用 域 为 全 局 HTTPSession 的 生命 周期 。 通 常用 于 门户 网 站 场 
景 ， 同 样 ， 只 有 基于 Web 的 Spring ApplicationContext 可 用 


请 求 (request) 


会 话 (session) 


全 局 会 话 (global session) 


我 们 可 以 以 XMLInstance 类 为 基础 演示 一 下 singleton 和 prototype 作用 域 。 
这 里 使 用 通过 BeanFactory 的 getBean 方法 获取 两 次 bean 对 象 。 


XMLInstance instance=(XMLInstance)factory.getBean("xmlinstance"); 
instance.setName ("123"); 

instance.Breath(); 

instance- (XMLInstance)factory.getBean ("xmlinstance") ; 
instance.Breath(); 


如 果 我 们 采用 bean 默认 的 作用 域 singleton， 如 下 配置 ， 那 么 两 个 getBean 获取 的 对 象 是 
一 致 的 。 
<bean id="xmlinstance" class="com.demo.model.XMLInstance" 
scope="singleton"> 
<property name-"air" ref="CleanAir"></property> 
<property name="name" value="abc"></property> 
</bean> 


输出 结果 : 


Name:123;Air:CleanAir 
Name:123;Air:CleanAir 


如 果 我 们 采用 bean 默认 的 作用 域 prototype， 如 下 配置 ， 那 么 两 个 getBean 获取 的 对 象 是 
不 一 致 的 。 


<bean id-"xmlinstance" class-"com.demo.model.XMLInstance" 
scope="prototype"> 
<property name-"air" ref="CleanAir"></property> 
<property name="name" value="abc"></property> 
</bean> 


48 


输出 结果 : 


Name:123;Air:CleanAir 
Name: abc;Air:CleanAir 


3.4.2 Bean 的 生命 周期 


前 面 章 节 介 绍 了 bean 容器 以 及 bean 的 配置 与 注入 , 本 节 学 习 bean 的 生命 周期 ( 见 图 3-1)， 
了 解 bean 是 怎么 来 的 、 怎 么 没 的 。 


调用 BeanPostProcessor 
的 postProcessBeforelnitialzation() 方 法 


调用 DisposableBean89destroy( 方 法 
调用 destroy-method 方 法 


洞 用 InitializingBean 
的 afterPropertiesSet( 访 法 


调用 init-method( 方 法 


调用 BeanPostProcessor 的 
postProcessAfterinitialization( 方 法 


实例 化 bean 
xe 


调用 BeanNameAware 
的 setBeanName() 方 法 


调用 BeanFactoryAware 
的 setBeanFactory() 方 法 
调用 ApplicationContextAware 
的 setApplicationContext() 方 法 


在 ApplicationContext 容器 中 ，Bean 的 生命 周期 流程 如 图 3-1 所 示 。 


CD 容器 启动 后 ， 会 对 scope X singleton 且 非 懒 加 载 的 bean 进行 实例 化 。 

(2) 按照 Bean 定义 信息 配置 信息 ， 注 入 所 有 的 属性 。 

(3) 如 果 Bean 实现 了 BeanNameAware 接口 ， 会 回调 该 接口 的 setBeanName() 方 法 ， 传 
入 该 Bean 的 id， 此 时 该 Bean 就 获得 了 自己 在 配置 文件 中 的 id。 

(4) 如 果 Bean 实现 了 BeanFactoryAware 接口 ， 会 回调 该 接口 的 stBeanFactory() 方 法 ， 
传 入 该 Bean 的 BeanFactory， 这 样 该 Bean 就 获得 了 自己 所 在 的 BeanFactory。 

(5) 如 果 Bean 实现 了 ApplicationContextAware 接口 ,会 回调 该 接口 的 setApplicationContext() 
方法 ， 传 入 该 Bean 的 ApplicationContext， 这 样 该 Bean 就 获得 了 自己 所 在 的 ApplicationContext。 

(6) 如 果 有 Bean 实现 了 BeanPostProcessor 接口 ， 就 会 回调 该 接口 的 postProcessBefore- 
Initialzation() 方 法 。 


Scope 
singleton EF 
在 spring ioc 容 器 


scope 为 
prototype: 
周期 交 治 客户 庙 


图 3-1 
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(7) 如 果 Bean 实现 了 InitializingBean 接口 ， 就 会 回调 该 接口 的 afterPropertiesSet() 方 法 。 

(8) 如 果 Bean 配置 了 init-method 方法 ， 就 会 执行 init-method 配置 的 方法 。 

(9) 如 果 Bean 实 现 了 BeanPostProcessor 接 口 ,就 会 回调 该 接口 的 postProcessAfterInitialization() 
方法 。 

(10) 之 后 ， 就 可 以 正式 使 用 该 Bean 了 。 对 于 scope W singleton 的 Bean, Spring 的 ioc 
容器 中 会 缓存 一 份 该 Bean 的 实例 ; 对 于 scope 为 prototype 的 Bean, 每 次 被 调用 都 会 新 建 一 个 
新 的 对 象 ， 其 生命 周期 就 交 给 调用 方 管理 了 ， 不 再 是 由 Spring 容器 进行 管理 了 。 

(11) 容器 关闭 后 ， 如 果 Bean 实现 了 DisposableBean 接口 ， 就 会 回调 该 接口 的 destroy() 
方法 。 

(12) 如 果 Bean 配置 了 destroy-method 方法 ， 就 会 执行 destroy-method 配置 的 方法 。 至 
此 ， 整 个 Bean 的 生命 周期 结束 。 


这 里 在 UserBean 类 基础 上 进行 改造 ， 增 加 name 属性 并 实现 ApplicationContextAware 接口 。 


package com.demo.model; 


import org.springframework.beans.BeansException; 

import org.springframework.beans.factory.BeanFactory; 
import org.springframework.beans.factory.BeanFactoryAware; 
import org.springframework.beans.factory.BeanNameAware; 
import org.springframework.beans.factory.DisposableBean; 
import org.springframework.beans.factory.InitializingBean; 
import org.springframework.context.ApplicationContext; 
import org.springframework.context.ApplicationContextAware; 


public class UserBean implements BeanNameAware,BeanFactoryAware, 
InitializingBean,DisposableBean,ApplicationContextAware { 


private String name; 
public String getName() ( 


return name; 


public void setName(String name) ( 
this.name - name; 
System.out.println("set 方法 被 调用 ") ; 


public UserBean() { 
System. out. print1n ("UserBean 类 构造 方法 ") ; 


public void setBeanName(String name) { 
System. out.print1n("BeanNameAware 被 调用 ") ; 
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public void setBeanFactory(BeanFactory beanFactory) throws 
BeansException ( 
System.out.println("BeanFactoryAware 被 调用 ") ; 


public void afterPropertiesSet() throws Exception { 
System. out.print1n("InitializingBean 被 调用 ") ; 


public void destroy() throws Exception { 
System. out.print1n("DisposableBean 被 调用 ") ; 

H 

// 自 定义 的 初始 化 函数 

public void myInit() { 
System.out.println("myInit 被 调用 ") ; 

} 

// 自 定义 的 销毁 方法 

public void myDestroy() { 
System.out.println("myDestroy 被 调用 ") ; 


public void setApplicationContext (ApplicationContext applicationContext) 
throws BeansException { 
System. out.print1n("setApplicationContext 被 调用 ") ; 


} 
定义 后 置 处 理 器 CusBeanPostProcessor, SE BeanPostProcessor 接口 。 


package com.demo.model; 


import org.springframework.beans.BeansException; 
import org.springframework.beans.factory.config.BeanPostProcessor; 


public class CusBeanPostProcessor implements BeanPostProcessor { 


public Object postProcessBeforeInitialization(Object bean, String 
beanName) throws BeansException { 
System.out.println("postProcessBeforeInitialization 被 调用 "); 
return bean; 


} 


public Object postProcessAfterInitialization(Object bean, String 
beanName) throws BeansException { 
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System. out.print1n ("post ProcessAfterInitialization 被 调用 "); 
return bean; 


} 
在 xml 中 配置 bean 和 BeanPostProcessor. 


<bean id="user" class="com.demo.model.UserBean" destroy-method="myDestroy" 
init-method="myInit"> 
<property name="name" value="abc"></property> 
</bean> 
<bean id="postProcessor" class="com.demo.model.CusBeanPostProcessor" /> 


测试 : 


ApplicationContext context-new ClassPathXmlApplicationContext (new 
String[]("applicationContext.xml"]); 

BeanFactory factory-context; 

UserBean user- (UserBean)context.getBean ("user"); 

((ClassPathXmlApplicationContext)context).close(); 


输出 结果 如 图 3-2 所 示 。 


UserBean 类 构造 方法 

set 方法 被 调用 

BeanNameAware 被 调用 

BeanFactoryAware 被 调用 
setApplicationContext 被 调用 
postProcessBeforeInitialization 被 调用 
InitializingBean 被 调用 

myInit 被 调用 
postProcessAfterInitialization 被 调用 
DisposableBean 被 调用 

myDestroy 被 调用 


UserBean 关 和 构 这 方法 


setra 
BeanNameAwarez as 
BeanFactoryAware:ss 
setApplicationContextz:ts 
postProcessBeforeInitializationz:s 
InitializingBeane24 
myInitz:ts 
postProcessAfterInitializatione:s** 
422, 2018 11:02:57 ¥+org.springframework. context. support. AbstractApplicationContext doClose 
Closing org.springframework.context.support.ClassPathXmlApplicationContext@45ff54e6: startup + 
DisposableBeane2= 
myDestroyz*4| 
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3.5 we 


本 章 主要 介绍 了 Bean 容器 BeanFactory 和 ApplicationContext, 学习 了 Bean 的 配置 和 注入 、 
Bean 的 作用 域 和 生命 周期 。 通 过 本 章 的 学 习 ， 了 解 了 Spring 最 核心 、 最 基本 的 模块 ， 为 后 面 
的 学 习 打 下 基础 。 
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在 上 一 章节 中 ， 我 们 大 致 了 解 了 Spring 核心 容器 ， 了 解 了 IOC 思想 在 Spring 中 的 具体 应 用 
Bean 容器 以 及 Bean 的 配置 与 使 用 ， 这 一 章 我 们 将 开始 学 习 AOP 在 Spring 框架 中 的 具体 应 用 。 


本 章 主要 涉及 的 知识 点 : 


© AOP 的 引入 : 从 传统 处 理 方法 到 AOP 处 理 ， 一 步 一 步 引 入 。 
© AOP 的 实现 方式 : 通过 实践 了 解 AOP 的 3 种 实现 方式 。 


4.1 AOP 基础 


在 第 2 章 中 也 有 介绍 AOP， 不 过 侧重 点 是 AOP 的 原理 和 动态 代理 ， 本 节 主 要 介绍 AOP 
的 基础 知识 点 。 


4.1.1 AOP 的 引入 


这 里 可 以 把 单个 模块 当 作 一 个 圆柱 ， 假 如 没有 AOP， 那 么 在 做 日 志 处 理 的 时 候 ， 我 们 就 
会 在 每 个 模块 中 添加 日 志 或 者 权限 处 理 ， 日 志 或 权限 类 似 圆柱 体 的 部 分 圆柱 ， 如 图 4-1 所 示 。 


图 4-1 


一 般 大 多 数 的 日 志 或 权限 处 理 代 码 是 相同 的 , 为 了 实现 代码 复 用 , 我 们 可 能 把 日 志 处 理 抽 
离 成 一 个 新 的 方法 ， 如 图 4-2 所 示 。 


$4 Spring z AOP 


即使 这 样 , 我 们 仍然 必须 手动 插入 这 些 方法 ， 而 且 这 两 个 方法 是 强 耦 合 的 。 假 如 此 时 我 们 
不 需要 这 个 功能 了 ， 或 者 想 换 成 其 他 功能 ， 就 必须 一 个 个 修改 。 

通过 动态 代理 ， 可 以 在 指定 位 置 执行 对 应 流程 。 这 样 就 可 以 将 一 些 横向 的 功能 抽 离 出 来 ， 
形成 一 个 独立 的 模块 然后 在 指定 位 置 插入 这 些 功 能 。 这 样 的 思想 被 称 为 面向 切面 编程 ， 亦 即 
AOP， 如 图 4-3 所 示 。 


方法 1 方法 2 方法 3 


42 图 4-3 
4.1.2. AOP Xx € 


4.1.1 小 节 介绍 了 引入 AOP 的 好 处 ， 本 小 节 来 了 解 一 下 AOP 的 几 个 核心 概念 。 


(1) 横 切 关注 点 
AOP 把 一 个 业务 流程 分 成 几 部 分 ， 例 如 权限 检查 、 业 务 处 理 、 日 志 记 录 ， 每 个 部 分 单独 
处 理 ， 然 后 把 它们 组 装 成 完整 的 业务 流 ， 每 部 分 被 称 为 切面 或 关注 点 。 


(2) 切面 

类 是 对 物体 特征 的 抽象 ,切面 就 是 对 横 切 关注 点 的 抽象 .可 以 将 每 部 分 抽象 成 一 登 纸 一 样 ， 
一 层 一 层 的 ， 那 么 每 张 纸 都 是 一 个 切面 。 

(3) 连接 点 

因为 Spring 只 支持 方法 类 型 的 连接 点 , 所 以 在 Spring 中 连接 点 指 的 就 是 被 拦截 到 的 方法 ， 
实际 上 连接 点 还 可 以 是 字段 或 者 构造 器 。 其实, Spring 只 支持 方法 类 型 的 连接 点 包含 字段 和 构 
造 器 。 因 为 字段 通过 get. set 方法 得 到 ， 构 造 器 其 实 也 是 方法 。Spring 只 支持 方法 类 型 的 连接 
点 和 连接 点 是 字段 或 者 构造 器 是 包含 关系 。 


(4) 切入 点 
对 连接 点 进行 拦截 的 定义 。 连 接点 可 以 有 很 多 , 但 并 不 一 定 每 个 连接 点 都 进行 操作 ， 比 如 
莲 藉 ， 夭 段 与 藉 段 之 间 是 有 连接 点 的 ， 但 不 一 定 都 切 开 。 
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(5) 通知 
通知 指 的 就 是 指 拦截 到 连接 点 之 后 要 执行 的 代码 ， 分 为 前 置 、 后 置 、 异 常 、 最 终 、 环 绕 通 
知 5 类。 这 个 有 点 类 似 于 把 夭 段 与 夭 段 断 开 之 后 要 做 的 事情 ， 是 往 里 面 加 蜂蜜 还 是 做 什么 。 


(6) 目标 对 象 
代理 的 目标 对 象 ， 就 是 动态 代理 的 target， 在 实际 操作 中 一 般 会 先 实现 AOP 的 接口 ， 然 
后 配置 这 些 接口 作用 到 哪些 对 象 上 ， 被 作用 的 对 象 就 是 目标 对 象 。 


(7) 织 入 

切面 是 独立 的 ， 目 标 对 象 也 是 独立 的 ， 它 们 是 不 耦合 的 ， 那 它 怎么 把 切面 放 到 目标 对 象 中 
We? 这 时 就 需要 进行 织 入 操作 ， 就 类 似 这 种 的 ， 怎 么 把 target 和 打印 日 志 联 系 到 一 起 呢 ? 使 用 
动态 代理 。 在 Spring 中 ，aop.framework.ProxyFactory 用 作 织 入 器 ， 进 行 横 切 逻辑 的 织 入 。 


(8) 引入 
不 改 代 码 的 同时 ， 为 类 动态 地 添加 方法 或 字段 。 


4... 2. AOP 实现 


4.1 节 主 要 介绍 了 AOP 的 理论 知识 ， 本 节 通 过 示例 进一步 理解 Spring 中 AOP 的 使 用 ， 主 
要 介绍 AOP 的 3 种 实现 方式 : 经 典 的 基于 代理 的 AOP、Aspect 基于 XML 的 配置 、AspectJ 
基于 注解 的 配置 。 

1. 经 典 的 基于 代理 的 AOP 


基于 代理 的 AOP 主要 介绍 MethodBeforeAdvice、AfterReturningAdvice、ThrowsAdvice 三 
个 接口 的 使 用 。 
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MethodBeforeAdvice: 见 名 知 意 ， 通 过 方法 名 就 可 以 猜 到 它 的 作用 。 方 法 前 拦截 器 在 执行 
指定 方法 前 调用 ， 参 数 分 别 为 被 调用 的 方法 、 执 行 时 被 传 入 的 参数 、 被 拦截 的 Bean。 
AfterRetumingAdvice: 返回 后 拦截 器 ,在 执行 完 指定 方法 并 返回 之 后 调用 。 如 果 有 返回 值 
可 以 获取 到 返回 值 ， 否 则 为 nule 参数 分 别 为 方法 返回 值 、 被 调用 的 方法 、 执 行 时 被 传 入 
的 参数 、 被 拦截 的 Bean. 

ThrowsAdvice: 异常 拦截 器 ， 在 指定 方法 抛 出 异常 时 被 调用 。 该 接口 并 未 定义 方法 ， 因 此 
不 需要 实现 任何 方法 。 那 它 是 怎么 拦截 的 呢 ? 我 们 可 以 查看 该 接口 的 定义 , 在 定义 类 文档 
中 有 如 图 4-4 所 示 的 说 明 。 例 如 ， 在 实现 该 接口 的 类 中 定义 了 public void 
afterThrowing(Exception ex), public void afterThrowing(Method method, Object[] args, Object 
target, Exception ex) 方 法 抛 出 异常 时 就 会 被 调用 。 
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Do * Tag interface for throws advice. 
2  * «p»There are not any methods on this interface, as methods are invoked by 
3 * reflection. Implementing classes must implement methods of the form 
ES 
5 * «pre class-"code"»void afterThrowing([Method, args, target], ThrowableSubclass);</pre 
— 
7 * <p>Some examples of valid methods would be 
ks 
9 * «pre "code"»public void afterThrowing(Exception ex)«/pre 
e * «pre "code"»public void afterThrowing(RemoteException)c/pre 
1 * «pre code"»public void afterThrowing(Method method, Object[] args, Object target, Exception ex)</pre 
2 * «pre "code"»public void afterThrowing(Method method, Object[] args, Object target, Servlettxception ex)</pre 
M. 
B4 * The first three arguments are optional, and only useful if we want further 
35 * information about the joinpoint, as in Aspect) <b>after-throwing</b> advice. 
36 e. 
B7 * <p><b>Note:</b> If a throws-advice method throws an exception itself, it will 
B8 * override the original exception (i.e. change the exception thrown to the user). 
B9 * The overriding exception will typically be a Runtimetxception; this is compatible 
Ə * with any method signature. However, if a throws-advice method throws a checked 
1 * exception, it will have to match the declared exceptions of the target method 
2 * and is hence to some degree coupled to specific target method signatures. 
3 * «b»Do not throw an undeclared checked exception that is incompatible with 
* the target method's signature!</b 


图 4-4 


在 软件 开发 中 推荐 面向 接口 的 编程 ， 所 以 这 里 创建 一 个 IAOPServices 接口 ， 并 定义 两 个 
方法 : withAopMethod 方法 将 使 用 拦截 器 拦截 的 方法 ，withNoAopMethod 方法 不 会 被 拦截 器 拦 
截 。 接 口 代码 如 下 : 


Package basicAop; 

Public interface IAOPServices { 
Public String withAopMethod() throws Exception; 
Public String withNoAopMethod() throws Exception; 


} 


在 AOPServicesImpl 类 中 实现 了 该 接口 ,并 在 该 类 中 定义 了 String 类 型 的 description 属性 ， 
以 及 对 应 的 getter、setter 方法 。 两 个 接口 方法 将 返回 该 description 属性 的 值 。 


Package basicAop; 
public class AOPServicesImpl implements IAOPServices { 
private String description; 


public String getDescription() ( 
return description; 


public void setDescription(String description) { 
this.description - description; 
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public String withAopMethod() throws Exception { 
System. out.print1n ("AOP 函数 运行 方法 :withRaopMethod") ; 
if (description.trim() .length()==0) { 
throw new Exception ("description 属性 不 能 为 空 ") ; 
I 
return description; 


public String withNoAopMethod() throws Exception ( 
System.out.println("J5 AOP 函数 运行 方法 :withNoAopMethod"); 
return description; 


} 


上 面 把 要 使 用 AOP 拦截 的 方法 准备 好 了 ， 下 面 就 是 定义 AOP 拦截 器 方法 了 。 这 里 在 
AOPInterceptor 类 中 实现 了 上 面 的 AfterReturningAdvice、MethodBeforeAdvice、ThrowsAdvice 
三 个 接口 。 


package basicAop; 
import java.lang.reflect.Method; 


import org.springframework.aop.AfterReturningAdvice; 
import org.springframework.aop.MethodBeforeAdvice; 
import org.springframework.aop.ThrowsAdvice; 


public class AOPInterceptor implements 
AfterReturningAdvice, MethodBeforeAdvice, ThrowsAdvice { 


public void afterReturning(Object value, Method method, Object[] args, 
Object instance) throws Throwable { 


System. out.print1n ("F}k"+method. getName ()+" 运 行 结束 , 返回 值 为 :" 
*value); 


) 


public void before (Method method, Object[] args, Object instance) throws 
Throwable ( 
System.out.println(" 执 行 MethodBeforeAdvice， 即 将 执行 的 方法 :" 
+method.getName () ) 7 
if(instance instanceof AOPServicesImpl) 
{ 
String 
description=( (AOPServicesImpl)instance) .getDescription(); 
if (description==null) 
{ 
throw new NullPointerException ("description 属性 不 能 为 nu11"); 
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H 
public void afterThrowing (Exception ex) { 
System.out.println ("dail T A% :"tex.getMessage()); 


public void afterThrowing (Method method, Object[] args, Object target, 
Exception ex) { 
System.out.println(" 方 法 "+method.getName ()+" 抛 出 了 异常 :" 
+ex.getMessage()); 
H 
} 


这 里 要 拦截 的 方法 和 拦截 器 都 准备 好 了 , 怎么 将 拦截 器 用 于 拦截 该 方法 呢 ? 这 里 就 需要 进 
行 配置 了 。 首 先 在 pom.xml 中 引入 依赖 ， 这 里 引入 spring-aop、spring-context。 


<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
<modelVersion>4.0.0</modelVersion> 
<groupId>com. demo</groupId> 
<artifactId>BasicAOP</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<properties> 
<project. build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
<spring.version>5.0.0.RELEASE</spring.version> 
</properties> 
<dependencies> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 
<version>${spring.version}</version> 
</dependency> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-aop</artifactId> 
<version>${spring.version}</version> 
</dependency> 
</dependencies> 
</project> 


实际 上 Spring 无 法 将 Services 实现 类 与 拦截 器 直接 组 装 ， 因为 没有 对 应 的 setter、getter 方法 。 
安装 时 ， 先 借助 Spring 中 的 代理 类 将 自 定义 拦截 器 注入 NameMatchMethodPointcutAdvisor 类 的 
advice 属性 中 ， 再 将 定义 好 的 NameMatchMethodPointcutAdvisor 对 象 注 入 ProxyFactoryBean 中 。 
这 里 将 自 定义 的 AOPInterceptor 拦截 器 注入 NameMatchMethodPointcutAdvisor 中 ， 然 后 将 
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NameMatchMethodPointcutA dvisor X$ REE A ProxyFactoryBean 中 。 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns-"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/context" 
xmlns:aop="http://www. springframework.org/schema/aop" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring- 
context.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd"» 


<bean id-"aopInterceptor" class-"org.springframework.aop.support. 
NameMatchMethodPointcutAdvisor"> 
<property name="advice"> 
<bean class="basicAop.AOPInterceptor"></bean> 
</property> 
<property name="mappedName" value="withAopMethod"></property> 
</bean> 


<bean id-"aopService" class="org.springframework.aop. framework. 
ProxyFactoryBean"> 
<property name="interceptorNames"> 
<list> 
<value>aopInterceptor</value> 
</list> 
</property> 
<property name="target"> 
<bean class-"basicAop.AOPServicesImpl"» 
<property name-"description" value="basicAop"></property> 
</bean> 
</property> 
</bean> 
</beans> 


从 Spring 容器 中 获取 IAOPServices 对 象 , 并 分 别 执行 IJAOPServices 中 的 两 个 方法 。 Spring 
会 在 withAopMethod() 方 法 前 后 添加 拦截 器 ， 在 withNoAopMethod() 方 法 前 后 并 不 会 添加 。 


public class AopTest { 
public static void main(String[] args) throws Exception { 
ApplicationContext context-new ClassPathXmlApplicationContext (new 


String[]("applicationContext.xml"]); 
BeanFactory factory-context; 
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IAOPServices services=(IAOPServices) context.getBean ("aopService") ; 
services.withAopMethod () ; 
services.withNoAopMethod(); 


执行 MethodBeforeAdvice ,即将 执行 的 方法 :withAopMethod 
AOP 函 数 运行 方法 :withAopMethod 


方法 withAopMethod 运 行 结束 ,返回 值 为 :basicAop 
无 AOP 函 数 运行 方法 :withNoAopMethod 


2. AspectJ 基于 XML 的 配置 


Aspect) 是 一 个 面向 切面 的 框架 ， 扩展 了 Java 语言 。Aspect 定义 了 AOP 语法 ， 有 一 个 专 
门 的 编译 器 ， 用 来 生成 遵守 Java 字 节 编码 规范 的 Class 文件 。 我 们 还 是 利用 IAOPServices 接 
口 、AOPServicesImpl 类 实现 AspectJ 基于 XML 的 AOP 编程 。 X 4-1 给 出 Aspect! 主要 的 配置 
元 素 。 使 用 Aspect 时 需要 引入 两 个 依赖 项 ， 即 aopalliance、aspectjweaver。 在 引入 这 两 个 依 
赖 项 时 需要 注意 ， 有 时 会 报错 ， 更 新 两 个 依赖 项 的 版 本 就 好 了 。 


<dependency> 
<groupId>aopalliance</groupId> 
<artifactId>aopalliance</artifactId> 
<version>1.0</version> 

</dependency> 

<!-- https://mvnrepository.com/artifact/org.aspectj/aspectjweaver --> 

<dependency> 
<groupId>org.aspectj</groupId> 
<artifactId>aspectjweaver</artifactId> 
<version>1.8.11</version> 

</dependency> 


3k 4-1 Aspect) 主要 的 配置 元 素 


<aop:config> 顶层 的 AOP 配置 元 素 ， 大 多 数 的 <aop:*> 元 素 必须 包含 在 <aop:config> 元 素 内 
<aop:aspect> 定义 切面 
<aop:aspect-autoproxy> 启用 @AspectJ 注解 驱动 的 切面 


<aop:pointcut> 定义 切 点 

<aop:advisor> 定义 AOP 通知 器 

<aop:before> 定义 AOP 前 置 通知 

<aop:after> JEX AOP 后 置 通知 〈 不 管 被 通知 的 方法 是 否 执行 成 功 ) 
<aop:after-returning> 定义 成 功 返回 后 的 通知 
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(RR) 


AOP 配置 元 素 描 o 
<aop:after-throwing> 定义 抛 出 异常 后 的 通知 


<aop:around> 定义 AOP 环绕 通知 
<aop:declare-parents> 为 被 通知 的 对 象 引 入 额外 的 接口 ， 并 透明 地 实现 


这 里 定义 了 XMLAdvice 拦截 器 方法 ， 用 于 演示 前 置 、 后 置 、 成 功 返 回 、 异 常 返回 、 环 绕 
通知 。 
Package Services; 


import org.aspectj.lang.JoinPoint; 
import org.aspectj.lang.ProceedingJoinPoint; 


public class XMLAdvice { 
public void beforeAdvice() { 
System.out.println(" 前 置 通知 执行 了 ") ; 


public void afterAdvice() { 
System. out.print1n ("后 置 通知 执行 了 "); 


public void afterReturnAdvice(String result) { 
System.out.println(" 返 回 通 知 执行 了 " + "运行 业务 方法 返回 的 结果 为 "+ 
result); 


} 


public String aroundAdvice(ProceedingJoinPoint proceedingJoinPoint) 
throws Throwable { 
String result = ""; 
try { 
System. out.print1n (" 环 绕 通知 开始 执行 了 ") ; 
long start = System.currentTimeMillis(); 
result = (String) proceedingJoinPoint.proceed(); 
long end = System.currentTimeMillis(); 
System. out.print1n (" 环 绕 通知 执行 结束 了 ") ; 
System.out.println ("执行 业务 方法 共计 : " + (end - start) + "毫秒 。") ; 
} catch (Throwable e) { 


} 


return result; 


public void throwingAdvice(JoinPoint joinPoint, Exception e) { 
StringBuffer stringBuffer = new StringBuffer(); 
stringBuffer.append(" 异 常 通知 执行 了 .") 7 
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stringBuffer.append("Zjik:") .append(joinPoint.getSignature(). 
getName () ) .append (" 出 现 了 异常 .") ; 

stringBuffer.append (" 异 常 信息 为 :") .append(e.getMessage()); 

System.out.println(stringBuffer.toString()); 


) 


上 面 把 拦截 器 定义 完了 ， 之 后 就 是 把 定义 好 的 拦截 器 与 Services 关联 在 一 起 。 使 用 AOP 
配置 元 素 将 Services 与 拦截 器 中 的 方法 关联 上 。 


<bean id="serviceImplA" class-"Services.AOPServicesImpl"» 
<property name-"description" value="basicAop"></property> 

</bean> 

<bean id="serviceAspectBean" class= 

<aop:config> 


Services.XMLAdvice" /> 


<aop:aspect id="serviceAspect" ref="serviceAspectBean"> 
<aop:pointcut id-"servicePointcut" expression="execution (* 
Services.*.withAop*(..))" /> 
<aop:before pointcut-ref-"servicePointcut" method="beforeAdvice" /> 
<aop:after pointcut-ref-"servicePointcut" method-"afterAdvice" /> 
<aop:after-returning pointcut-ref-"servicePointcut" 
method-"afterReturnAdvice" returning-"result" /> 
<aop:around pointcut-ref-"servicePointcut" method- "aroundAdvice" /> 
<aop:after-throwing pointcut-ref-"servicePointcut" 
method-"throwingAdvice" throwing-"e" /» 
</aop:aspect> 
</aop:config> 
</beans> 


配置 完 之 后 还 是 和 经 典 的 基于 代理 的 AOP 一 样 ， 运 行 代 码 从 Spring 容器 中 获取 
IAOPServices 对 象 ， 并 分 别 执行 IAOPServices 中 的 两 个 方法 。Spring 会 在 withAopMethod() 方 
法 前 后 添加 拦截 器 ， 在 withNoAopMethod() 方 法 前 后 并 不 会 添加 。 


public class App { 
public static void main(String[] args) throws Exception { 


ApplicationContext context-new ClassPathXmlApplicationContext (new 
String[]("applicationContext.xml"]); 

BeanFactory factory-context; 

IAOPServices services- (IAOPServices)context.getBean("serviceImplA"); 

services.withAopMethod(); 

services.withNoAopMethod(); 
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信息 : Overriding bean definition for bean 's 
前 置 通知 执行 了 

环绕 通知 开始 执行 了 

AOP 函 数 运行 方法 :withAopMethod 

环绕 通知 执行 结束 了 

执行 业务 方法 共计 : 6 毫秒。 

返回 通知 执行 了 运行 业务 方法 返回 的 结果 为 DasicAop 

后 置 通知 执行 了 

无 AOP 函 数 运 行 方法 :withNoAopMethod 


3. AspectJ 基于 注解 的 配置 


Aspect] 基于 XML 的 配置 还 是 需要 在 XML 中 配置 AOP 元 素 。 现 在 一 般 提倡 使 用 注解 来 
进行 编程 ，Aspect 也 提供 了 基于 注解 的 实现 方式 。 基 于 注解 的 AOP 配置 其 实 和 基于 XML 的 
一 样 ， 可 以 参照 基于 XML 的 来 进行 理解 。 这 里 定义 了 AnnontationAdvice， 并 用 @Aspect 注解 
定义 切面 。 在 XML 中 的 配置 元 素 改 成 了 注解 关键 字 。 


package Services; 


import org.aspectj.lang.JoinPoint; 

import org.aspectj.lang.ProceedingJoinPoint; 
import org.aspectj.lang.annotation.After; 

import org.aspectj.lang.annotation.AfterReturning; 
import org.aspectj.lang.annotation.AfterThrowing; 
import org.aspectj.lang.annotation.Around; 

import org.aspectj.lang.annotation.Aspect; 

import org.aspectj.lang.annotation.Before; 

import org.springframework.stereotype.Component; 


GComponent 
GAspect 
public class AnnontationAdvice ( 


@Before ("execution(* Services.*.withAop*(..))") 
public void beforeAdvice() { 
System.out.println(" 前 置 通知 执行 了 ") ; 


@After ("execution(* Services.*.withAop*(..))") 
public void afterAdvice() { 
System. out.println(" 后 置 通知 执行 了 ") ; 


@AfterReturning (value="execution(* Services.*.withAop*(..))", 
returning="result") 
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public void afterReturnAdvice (String result) { 
System.out.println(" 返 回 通知 执行 了 ”+ "运行 业务 方法 返回 的 结果 为 "+ 


result); 
} 


@Around (value="execution(* Services.*.withAop*(..))") 
public String aroundAdvice (ProceedingJoinPoint proceedingJoinPoint) 
throws Throwable ( 
String result - 
try ( 
System.out.println ("环绕 通知 开始 执行 了 "); 


long start = System.currentTimeMillis(); 


result = (String) proceedingJoinPoint.proceed(); 

long end = System.currentTimeMillis(); 

System.out.println ("环绕 通知 执行 结束 了 "); 

System. out.println ("执行 业务 方法 共计 : " + (end - start) + "毫秒 。") ; 
} catch (Throwable e) { 


} 
return result; 
@AfterThrowing (value="execution(* Services.*.withAop*(..))", 
throwing="e") 
public void throwingAdvice(JoinPoint joinPoint, Exception e) { 
StringBuffer stringBuffer = new StringBuffer(); 
stringBuffer.append(" 异 常 通知 执行 了 .") ; 
stringBuffer.append("7jik:").append(joinPoint.getSignature(). 
getName () ) .append (" 出 现 了 异常 .") ; 
stringBuffer.append(" 异 常 信息 为 :") .append(e.getMessage()); 
System. out.println(stringBuffer.toString()); 


} 


在 配置 文件 中 只 需 配 置 一 下 自动 扫描 的 包 名 , 并 配置 <aop:aspectj-autoproxy> 即 可 , 比 XML 
的 配置 简单 一 些 。 


<!-- 配置 自动 扫描 的 包 --> 
<context:component-scan base-package="Services"></context:component-scan> 
<!-- 自动 为 切面 方法 中 匹配 的 方法 所 在 的 类 生成 代理 对 象 。 --> 
«aop:aspectj-autoproxy»«/aop:aspectj-autoproxy» 
最 后 从 Spring 容器 中 获取 IAOPServices 对 象 ， 并 分 别 执行 IJAOPServices 中 的 两 个 方法 。 
运行 结果 如 下 ， 从 打印 的 日 志 可 以 看 到 拦截 器 拦截 了 withAopMethod0 方 法 ， 并 未 拦截 
withNoAopMethod(): 
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信息 : Overriding bean definition for bean 
环绕 通知 开始 执行 了 

前 置 通知 执行 了 

AOP 函 数 运行 方法 :withAopMethod 
环绕 通知 执行 结束 了 

执行 业务 方法 共计 : 1 毫秒 。 

后 置 通知 执行 了 

返回 通知 执行 了 运行 业务 方法 返回 的 结果 为 basicAop 
无 AOP 函 数 运行 方法 :withNoAopMethod 


4.3 we 


本 章 主要 从 传统 处 理 方式 一 步 一 步 地 引入 AOP， 介 绍 AOP 的 主要 概念 ， 并 列举 了 AOP 
的 3 种 实现 。 通 过 本 章 的 学 习 ， 对 AOP 思想 有 了 更 深入 的 认识 。 其 实 ， 实 现 AOP 还 有 其 他 
方式 ， 这 里 就 不 一 一 列举 了 。 
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在 上 一 章节 中 ， 我 们 了 解 了 Spring 框架 中 的 AOP 模块 ， 这 一 章节 我 们 开始 学 习 Spring 框架 
中 的 DAO 模块 。 


本 章 主要 涉及 的 知识 点 : 


JDBC 基本 用 法 : Statement、PreparedStatement、CallableStatement 的 使 用 。 

JDBC 高 级 用 法 : 批 处 理 、 事 务 处 理 。 

Spring DAO 模块 : JdbcDaoSupport、MappingSqlQuery 等 对 象 的 使 用 。 

Spring 事务 管理 : TransactionProxyFactoryBean 、DataSourceTransactionManager 的 配置 
与 使 用 。 


5.1 JDBC 详解 


在 了 解 Spring 的 DAO 模块 时 需要 有 一 定 的 数据 库 基础 , Java 语言 与 数据 库 连 接 使 用 的 是 
JDBC， 所 以 有 必要 学 习 一 下 JDBC 的 内 容 。 


5.1.1 JDBC 介绍 


JDBC (Java DB Connection, Java 数据 库 连 接 ) 是 一 种 可 用 于 执行 SQL 语句 的 Java API 
(Application Programming Interface， 应 用 程序 设计 接口 )。 它 由 一 些 Java 语言 编写 的 类 和 界 

面 组 成 。 JDBC 为 数据 库 应 用 开发 人 员 和 数据 库 前 台 工 具 开 发 人 员 提 供 了 一 种 标准 的 应 用 程序 
设计 接口 ， 使 开发 人 员 可 以 用 纯 Java 语言 编写 完整 的 数据 库 应 用 程序 。JDBC 代表 Java 数据 
库 连接 。 它 是 一 个 软件 层 ， 人 允许 开发 者 在 Java 中 编写 客户 端 /服务 器 应 用 。 

通过 使 用 JDBC， 开 发 人 员 可 以 很 方便 地 将 SQL 语句 传送 给 几乎 任何 一 种 数据 库 。 也 就 
是 说 , 开发 人 员 可 以 不 必 写 一 个 程序 访问 Sybase， 写 另 一 个 程序 访问 Oracle, 再 写 一 个 程序 访 
là] Microsoft 的 SQL Server. 用 JDBC 写 的 程序 能 够 自动 将 SQL 语句 传送 给 相应 的 数据 库 管理 
系统 (DBMS) 。 不 但 如 此 ， 使 用 Java 编写 的 应 用 程序 可 以 在 任何 支持 Java 的 平台 上 运行 ， 
不 必 在 不 同 的 平台 上 编写 不 同 的 应 用 。Java 和 JDBC 的 结合 可 以 让 开发 人 员 在 开发 数据 库 应 用 
时 真正 实现 “Write Once，Run Everywhere! ”。 
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5.1.2 ”操作 步骤 

JDBC 可 以 连接 不 同 的 数据 库 ， 不 同 的 数据 库 也 可 以 被 不 同 的 工具 连接 ， 但 在 连接 时 基本 
都 是 固定 的 几 个 步骤 。 

1. 驱动 引入 


JDBC 是 对 外 开放 的 接口 ， 数 据 库 提 供 商 实现 了 这 些 接口 ， 这 些 接口 的 组 合 就 是 驱动 。 数 
据 库 有 好 多 种 ， 例 如 MySQL. Oracle 等 ， 需 要 注册 不 同 的 驱动 来 操作 对 应 的 数据 库 ， 注 册 驱 
动 也 得 要 有 驱动 才 是 ， 所 以 首先 要 将 驱动 引入 项 目 。 


2. 注册 驱动 

引入 驱动 之 后 应 用 程序 也 不 知道 是 用 的 什么 数据 库 ， 只 是 把 驱动 下 载 了 下 来 放 到 项 目 中 ， 
所 以 得 注册 一 下 才 知 道 是 谁 ， 注 册 之 后 会 返回 对 应 的 驱动 管理 对 象 。 就 和 入 职 一 样 ， 你 到 公司 
了 但 不 报到 ， 那 也 不 知道 来 了 没 来 ， 报 到 了 才 会 有 针对 个 人 的 流程 。 


3. 创建 连接 


数据 库 和 应 用 程序 是 分 隔 开 来 的 ,数据库 可 能 存放 在 远程 , 那 怎 么 和 数据 库 措 上 呢 ? 这 就 
需要 连接 了 。 


4. 执行 操作 

连接 上 之 后 要 干什么 呢 , 不 能 一 直 连 着 不 干事 情 啊 ,这 也 是 资源 的 一 种 浪费 ,所 以 连接 之 
后 执行 数据 库 的 操作 增 、 删 、 改 、 查 等 。 

5. 返回 结果 


增 、 删 、 改 、 查 操作 结束 之 后 ， 总 要 有 一 个 结果 ， 不然 怎么 知道 成 功 与 否 ， 查询 的 话 会 返 
回 查询 的 数据 ， 增 加 、 删 除 、 修 改 会 返回 影响 的 行 数 。 


6. 释放 资源 


把 结果 也 返回 了 ,但 不 能 老 连 着 数据 库 , 这 样 占用 资源 ,创建 的 对 象 也 没有 释放 ， 还 占 空 
间 ， 所 以 用 完了 就 把 它 关 掉 。 


5.1.3 Statement 的 使 用 


Statement 是 Java 执行 数据 库 操作 的 一 个 重要 接口 ,用 于 在 已 经 建立 数据 库 连 接 的 基础 上 ， 
向 数据 库 发 送 要 执行 的 SQL 语句 。Statement 对 象 用 于 执行 静态 SQL 语句 ， 并 返回 它 所 生成 
结果 的 对 象 。 

默认 情况 下 ， 同 一 时 间 每 个 Statement 对 象 只 能 打开 一 个 ResultSet 对 象 。 因 此 ， 如 果 读 取 
一 个 ResultSet 对 象 与 读 取 另 一 个 交叉 ,那么 这 两 个 对 象 必 须 是 由 不 同 的 Statement 对象 生 成 的 。 
如 果 存 在 某 个 语句 打开 的 当前 ResultSet 对 象 , 那么 Statement 接口 中 的 所 有 执行 方法 都 会 隐 式 
关闭 它 。 
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在 使 用 Statement 之 前 先进 行 数据 准备 ， 这 里 在 本 地 MySQL 中 创建 了 一 个 数据 库 
daodemodb 和 一 张 表 t_user， 并 在 表 中 增加 了 几 条 数据 用 来 测试 。 


/* 数据 库 创建 */ 
CREATE DATABASE ^daodemodb' /*!40100 DEFAULT CHARACTER SET utf8 */; 
/* 创 建 测试 表 */ 
CREATE TABLE ^t user' ( 
^id" int(11) NOT NULL AUTO INCREMENT, 
^name? varchar(45) DEFAULT NULL, 
^age" int(11) DEFAULT NULL, 
^money? decimal(10,2) DEFAULT NULL, 
PRIMARY KEY ("id") 
) ENGINE-InnoDB DEFAULT CHARSET-utf8; 
/* 数 据 准备 */ 
insert into t_user(name,age,money) 
values 
('HRE','24', 666.66), 
(EDU, 125", 888.88), 
('E—','26',999,99), 
(4 小 明 ' 271,555.55), 
("AN , 128", 333.33) 


按照 上 面 的 操作 步骤 ， 需 要 引入 驱动 ， 这 里 使 用 pom.xml 引入 mysql 的 jdbc 驱动 。 


<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>8.0.12</version> 

</dependency> 


然后 就 是 在 代码 中 依次 注册 驱动 、 创 建 连 接 、 执 行 操作 、 返 回 结果 、 释 放 资 源 步骤 ， 下 面 
代码 演示 的 就 是 这 个 过 程 ， 从 t user 表 中 查询 数据 并 打印 到 日 志 中 。 


public static void main( String[] args ) throws SQLException 
ji 
Connection conn-null; 
Statement stmt-null; 
ResultSet rs-null; 
try{ 
// 注 册 驱 动 
DriverManager.registerDriver(new com.mysql.cj.jdbc.Driver()); 
// 通 过 注册 的 驱动 获得 连接 对 象 Connection 
conn=DriverManager. getConnection("jdbc:mysql://127.0.0.1:3306/ 
daodemodb? 
useUnicode-true&characterEncoding-UTF-8" 
+ "&serverTimezone-UTC&useSSL-false","root","123456"); 


// 通 过 Statement 对 象 执行 操作 返回 结果 ResultSet 
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stmt=conn.createStatement (); 


// 返 回 结果 


rs=stmt.executeQuery("select * from t_user"); 


while (rs.next ()) { 


System. out.println ("##4:"+rs.getString ("name") +" 
余额 :"+rs.getDouble ("money") ) ; 


rs.getInt ("age") +" 


} 


catch (SQLException e) { 
System. out.println(e.getMessage()); 


} 


e.printStackTrace(); 


) 


finally( 
// 释 放 资 源 


if(conn!-null)( conn.close(); } 
if(stmt!-null)( stmt.close(); ) 
if(rs!-null)( rs.close(); } 


) 


输出 结果 : 


姓名 : 张 三 
姓名 : 李 四 
姓名 : 王 二 
姓名 :小 明 
姓名 :小 赵 


5.1.4 使 用 PreparedStatement 返回 自 增 主键 


实际 上 有 三 种 Statement 对 象 ， 它 们 都 作为 在 给 定 连接 上 执行 SQL 语句 的 包容 器 : 
Statement, PreparedStatement( 从 Statement 继承 而 来 ) 和 CallableStatement( 从 PreparedStatement 
继承 而 来 ) 。 它 们 都 专用 于 发 送 特定 类 型 的 SQL 语句 : Statement 对 象 用 于 执行 不 带 参数 的 简 
单 SQL 语句 ，PreparedStatement 对 象 用 于 执行 带 或 不 带 IN 参数 的 预 编译 SQL 语句 ; 
CallableStatement 对 象 用 于 执行 对 数据 库 已 存在 的 存储 过 程 的 调用 。Statement 接口 提供 了 执行 
语句 和 获取 结果 的 基本 方法 。PreparedStatement 接口 添加 了 处 理 IN 参数 的 方法 ; 而 
CallableStatement 添加 了 处 理 OUT 参数 的 方法 。 

这 里 向 t user 表 中 插入 一 条 数据 ， 并 返回 自 增 主 键 id 的 值 。 在 准备 SQL 时 使 用 ? 来 做 参 
数 的 占 位 符 ， 在 实例 化 PreparedStatement 对 象 之 后 对 SQL 进行 传 参 ， 这 样 也 能 防止 注入 式 


攻击 。 


Public static void main(String[] args) throws SQLException { 
// TODO Auto-generated method stub 


} 


年 龄 :24 
年 龄 :25 
年 龄 :26 
年 龄 :27 
年 龄 :28 


余额 : 
余额 : 
余额 : 
余额 : 
余额 : 


666. 
888. 
999. 
555. 
333. 


Connection conn-null; 
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PreparedStatement prestmt-null; 

ResultSet rs-null; 

try{ 
// 注 册 驱 动 
DriverManager.registerDriver(new com.mysql.cj.jdbc.Driver()); 
// 通 过 注册 的 驱动 获得 连接 对 象 Connection 
conn-DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/ 

daodemodb?useUnicode-true&characterEncoding-UTF-8"4 "&serverTimezone= 


UTC&useSSL-false","root","123456"); 


//PreparedStatement 对 象 

String sql="insert into t_user (name,age,money) values(?,?,?)"; 
prestmt=conn.prepareStatement (sql, Statement. RETURN_GENERATED_KEYS) ; 

prestmt.setString(1, "/4"); 

prestmt.setInt(2, 25); 

prestmt.setDouble (3,222.22); 

// 返 回 结果 

int result-prestmt.executeUpdate(); 

if (result>0) 


{ 


System. out.println ("HRH") ; 
rs=prestmt .getGeneratedKeys (); 
while (rs.next()) 


{ 
System.out.println ("生成 的 主键 ID 为 :"+rs.getInt (1)); 


} 

catch (SQLException e) { 
System. out.print1n(e.getMessage()); 
e.printStackTrace(); 

) 

finally( 
// 释 放 资 源 
if(conn!-null)( conn.close(); } 
if(prestmt!-null)( prestmt.close(); } 
if(rs!-null)( rs.close(); } 


新 增 成 功 
生成 的 主键 1D 为 :6 
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5.1.5 使 用 CallableStatement 调用 存储 过 程 
在 使 用 数据 库 的 过 程 中 ， 可 能 会 调用 存储 过 程 ， 可 以 使 用 CallableStatement 来 调用 存储 


© 调用 存储 函数 : (?- call <procedure-name>[(<arg1>,<arg2>, ...)]} o 
© ”调用 存储 过 程 : (call <procedure-name>[(<arg1>,<arg2>, ...)]) o 


通过 CallableStatement 对 象 的 registerOutParameter() 方法 注册 Out 参数 。 通 过 
CallableStatement 对 象 的 setXxx() 方 法 设 定 IN 或 In out 参数 ， 若 想 将 参数 设 为 null， 可 以 使 用 
setNull0 。 如 果 所 调用 的 是 带 返 回 参数 的 存储 过 程 ， 还 需要 通过 CallableStatement 对 象 的 
getXxx() 获 取 输 出 参数 。 

在 数据 库 中 创建 了 存储 过 程 p_selectUserByAge， 根 据 用 户 年 龄 查找 用 户 ， 存 储 过 程 一 个 
传 入 参数 age， 一 个 传 出 参数 count， 参 数 count 存放 根据 年 龄 查找 的 用 户 个 数 。 


CREATE PROCEDURE "p selectUserByAge' (age int, out count int) 
BEGIN 
set count-(select count(1) from t user t where t.age -age); 
select * from t user t where t.age -age; 
END 


在 下 面 的 代码 中 先 使 用 Connection 的 prepareCall 方法 来 实例 化 CallableStatement, 再 使 用 
CallableStatement 对 象 的 registerOutParameter 方 法 设置 传 入 参数 , 最 后 执行 存储 过 程 返回 结 


public static void main(String[] args) throws SQLException { 


Connection conn=null; 
CallableStatement callstmt=null; 
ResultSet rs=null; 
try{ 
// 注 册 驱 动 
DriverManager.registerDriver(new com.mysql.cj.jdbc.Driver()); 
// 通 过 注册 的 驱动 获得 连接 对 象 Connection 
conn-DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/ 
daodemodb?useUnicode-true&characterEncoding-UTF-8" 
* "&serverTimezone-UTC&useSSL-false","root","123456"); 
//CallableStatement 对 象 
callstmt-conn.prepareCall("(call p_selectUserByAge(?,?)}"); 
callstmt.setInt (1,25); 
// 设 置 传 入 参数 
callstmt.registerOutParameter(2, Types.INTEGER); 
rs-callstmt.executeQuery(); 
while (rs.next()) 
t 
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System. out.println("#4:"+rs.getString("name")+" 年 龄 :" + 
rs.getInt ("age") +" 出 生日 期 :"+rs .getDouble ("money") ) ; 
} 
System. out.print1n ("FRIEDEB i: "+callstmt.getInt (2)); 
} 
catch (SQLException e) { 
System. out.println(e.getMessage()); 
e.printStackTrace(); 
} 
finally( 
// 释 放 资 源 
if (conn!=null) { conn.close(); } 
if (callstmt!=null) { callstmt.close(); } 
if(rs!-null)( rs.close(); } 


姓名 : 李 四 年 龄 :25 ”出 生日 期 :888.88 
姓名 :小 李 年 龄 :25 ”出 生日 期 :222 .22 
存储 过 程 返 回 值 :2 


5.1.6” 批 处 理 


在 实际 开发 中 往往 会 批量 执行 SQL, Statement 和 PreparedStatement 都 支持 批量 执行 SQL 
语句 ， 但 这 些 SQL 必须 是 Insert. Update, Delete 这 种 执行 后 返回 一 个 Int 类 型 的 数 ， 表 示 影 
响 的 行 数 。Statement 和 PreparedStatement 都 是 通过 addBatch() 方 法 添加 一 条 SQL 语句 ， 通 过 
executeBatch() 方 法 批量 执行 SQL 语句 ， 返 回 一 个 Int 类 型 的 数组 ， 表 示 各 SQL 的 返回 值 ， 这 
样 就 减少 了 注入 驱动 、 创 建 连接 这 些 步骤 , 提升 了 效率 。 首 先 看 一 下 Statement 批 处 理 的 例子 : 


public static void main(String[] args) throws SQLException { 
// TODO Auto-generated method stub 
Connection conn=null; 


ResultSet rs-null; 
Statement stmt=null; 
try{ 
// 注 册 驱 动 
DriverManager.registerDriver(new com.mysql.jdbc.Driver()); 
// 通 过 注册 的 驱动 获得 连接 对 象 Connection 
conn-DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/ 
daodemodb?useUnicode-true&characterEncoding-UTF-8" 
* "&serverTimezone-UTC&useSSL-false","root","123456"); 
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stmt=conn.createStatement (); 
for(int i=0;i<2;i++) 
{ 
String sql="insert into t_user (name,age,money) 
values ('StatementTest"+it+"',"+25+i+",222.22)"; 
stmt .addBatch (sql); 


H 
// 批 处 理 
int [] result-stmt.executeBatch(); 
System. out.println ("影响 的 行 数 分 别 为 :"); 
for(int i=0;i<result.length;i++) 
{ 

System.out.print(result[i]+" "); 


} 
catch (SQLException e) 
{ 
System. out.print1n(e.getMessage()); 
e.printStackTrace(); 
) 
finally 
t 
// 释 放 资 源 
if(conn!-null) 
{ 
conn.close(); 
) 
if(stmt!-null) 
{ 
stmt.close(); 
} 
if (rs!=null) 
{ 
rs.close(); 


} 

由 于 Statement 无 法 传递 参数 ， 必 须 是 完整 的 SQL 语句 ， 因 此 先 将 SQL 拼接 之 后 通过 
addBatch(sql) 方 法 加 入 到 批 处 理 中 ， 然 后 通过 executeBatch 方法 执行 批 处 理 返 回 影响 行 数 的 数组 。 

输出 结果 : 


影响 的 行 数 分 别 为 : 


EN 
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PreparedStatement 既 可 以 是 完整 的 SQL， 也 可 以 用 带 参数 的 不 完整 的 SQL。 我 们 看 一 下 
使 用 PreparedStatement 进行 批 处 理 的 例子 。 


public static void main( String[] args ) throws SQLException 
{ 
Connection conn-null; 


ResultSet rs-null; 
PreparedStatement prestmt-null; 
try{ 
// 注 册 驱 动 
DriverManager.registerDriver(new com.mysql.jdbc.Driver()); 
// 通 过 注册 的 驱动 获得 连接 对 象 Connection 
conn-DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/ 
daodemodb?useUnicode-true&characterEncoding-UTF-8" 
* "&serverTimezone-UTC&useSSL-false","root","123456"); 
String sql="insert into t user (name,age,money) values(?,?,?)"; 
prestmt-conn.prepareStatement (sql); 
for(int i=0;i<2;i++) 
{ 
prestmt.setString(1, "PreparedStatementTest"+i) ; 
prestmt.setInt(2, 25+i); 
prestmt.setDouble (3,222.22); 
prestmt.addBatch(); 
) 
// 批 处 理 
int [] result-prestmt.executeBatch(); 
System.out.println(" 影 响 的 行 数 分 别 为 :") ; 
for(int i=0;i<result.length; i++) 
{ 
System.out.print(result[i]+" "); 


H 
catch(SQLException e) 

t 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

H 

finally 

t 
// 释 放 资 源 
if (conn!=null) 

{ 
conn.close(); 
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H 
if(prestmt!-null) 
t 
prestmt.close(); 
H 
if(rs!-null) 
t 
rs.close(); 
) 


} 


这 里 使 用 占 位 符 ? 来 初始 化 SQL,， 然 后 通过 不 带 参数 的 addBatch 加 入 批 处 理 中 ,最 后 还 是 
通过 executeBatch 执行 批 处 理 操 作 。 


执行 结果 : 


影响 的 行 数 分 别 为 : 
r 4 


上 面 演 示 了 Statement. PreparedStatement 批 处 理 的 使 用 ， 这 里 还 要 说 明 一 下 ， 批 量 执行 
SQL 需要 数据 库 的 支持 ， 有 些 数据 库 可 能 不 支持 。 批 量 处 理 将 多 条 SQL 语句 提交 给 数据 库 一 
块 执行 ， 效 率 高 一 些 ， 但 如 果 数 据 比 较 多 ， 比 如 几 万 条 SQL， 就 需要 分 批 次 执行 ， 例 如 200 
条 执行 一 次 ， 如 果 为 了 增加 一 致 性 ， 可 以 在 批量 处 理 的 基础 上 增加 事务 。 


5.1.7 事务 处 理 


关系 型 数据 库 一 般 都 支持 事务 。 事 务 有 四 大 特性 : 原子 性 、 一 臻 性、 隔离 性 、 持 久 性 。 


© 原子 性 : 原子 性 是 指 事务 包含 的 所 有 操作 要 么 全 部 成 功 ， 要 么 全 部 失败 回 滚 。 例 如 转账 ， 
A 账户 转 给 B 账户 ,包含 两 个 操作 ,将 A 账户 的 钱 减 去 ,然后 将 B 账户 加 上 对 应 的 钱 数 ， 
不 可 能 A 账户 减 了 B 账户 没 加 上 ， 也 不 可 能 A 账户 没 减 就 给 B 账户 加 上 了 。 两 个 操作 要 
么 都 成 功 ， 要 么 都 失败 。 

e 一 致 性 : 一 致 性 是 指 事务 必须 使 数据 库 从 一 个 一 致 性 状态 变换 到 另 一 个 一 致 性 状态 , 也 就 
是 说 一 个 事务 执行 之 前 和 执行 之 后 都 必须 处 于 一 致 性 状态 。 假 设 账户 A 和 账户 B 两 者 的 
钱 加 起 来 一 共 是 5000， 那 么 不 管 A 和 BB 之 间 如 何 转账 、 转 几 次 账 ， 事 务 结束 后 两 个 用 户 
的 钱 相 加 起 来 应 该 还 得 是 5000， 这 就 是 事务 的 一 致 性 。 这 个 就 涉及 隔离 级 别 的 问题 了 。 

e ”隔离 性 : 隔离 性 是 当 多 个 用 户 并 发 访问 数据 库 时 ， 比 如 操作 同一 张 表 时 ,数据 库 为 每 一 个 
用 户 开启 的 事务 ， 不 能 被 其 他 事务 的 操作 所 干扰 ， 多 个 并 发 事务 之 间 要 相互 隔离 。 

e 持久 性 :持久 性 是 指 一 个 事务 一 旦 被 提交 了 ,那么 对 数据 库 中 的 数据 的 改变 就 是 永久 性 的 ， 
即便 是 在 数据 库 系统 遇 到 故障 的 情况 下 也 不 会 丢失 提交 事务 的 操作 。 


本 例 中 使 用 t user 表 的 两 个 用 户 来 模拟 转账 操作 。 目 前 李 四 账 户 有 888.88 元 、 张 三 账户 
有 666.66 元 ， 让 用 户 李 四 给 用 户 张 三 转账 111.11 元 ， 使 两 个 账户 都 有 777.77 元 。 
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事务 有 两 个 结果 : 一 是 成 功 ， 二 是 回 滚 。 在 事务 中 ， 任 何 一 个 操作 发 生 异 常 都 会 回 滚 。 


public static void main( String[] args ) throws SQLException 
{ 


Connection conn=null; 


ResultSet rs=null; 

PreparedStatement prestmt=null; 

tryí 
// 注 册 驱 动 
DriverManager. registerDriver(new com.mysql.jdbc.Driver()); 
// 通 过 注册 的 驱动 获得 连接 对 象 Connection 
conn-DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/ 

daodemodb?useUnicode-true&characterEncoding-UTF-8" 
* "&serverTimezone-UTC&useSSL-false","root","123456"); 

/ FIER SES 
conn.setAutoCommit (false); 
String sql-"update t user set money-money-? where id-?"; 
prestmt-conn.prepareStatement (sql); 


prestmt.setDouble(1, 111.11); 
prestmt.setInt(2, 2); 
prestmt.addBatch(); 


prestmt.setDouble(1, -111.11); 
prestmt.setInt(2, 1); 
prestmt.addBatch(); 


// 批 处 理 


prestmt.executeBatch(); 


// 提 交 事 务 


conn.commit (); 


} 
catch (SQLException e) 
{ 

// 事 务 回 滚 


conn.rollback(); 
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System. out.println(e.getMessage()); 
e.printStackTrace(); 
} 
finally 
{ 
// 释 放 资 源 
if (conn!=null) 
{ 
conn.close(); 
H 
if(prestmt!-null) 
{ 
prestmt.close(); 
} 
if(rs!-null) 
t 
rs.close(); 


) 


) 


上 面 代码 只 是 做 测试 并 未 做 金额 是 否 满足 转账 要 求 检查 , 先 使 用 “conn.setAutoCommit(false);” 

将 自动 提交 设置 为 手动 提交 , 默认 是 自动 ,然后 批量 执行 两 个 SQL 语句 ， 在 “conn.commitO;” 

提交 事务 之 前 如 果 没 有 出 现 错误 ， 执 行 结果 会 保存 到 数据 库 ， 一 旦 出 现 异常 ， 就 会 执行 
“conn.rollback();” 回 深 操 作 。 执 行 上 面 代码 转账 成 功 的 输出 结果 如 下 : 


上 面 是 提交 成 功 的 例子 。 为 了 演示 事务 回 滚 ， 可 以 在 提交 事务 “conn.rollback0;” 之 前 制 
造 一 个 异常 “int a=1/0;”， 然 后 执行 ， 发 现 数据 库 的 值 并 不 会 改变 ， 并 抛 出 了 异常 。 


1 张 二 24 777.77 
2 Æ 25 777.77 
3 F- 26 999.99 
4 4 BR 27 555,55 
5 dix 28 333.33 
6 the 25 222.22 
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Spring DAO 模块 


Spring 的 DAO 模块 提供 了 对 JDBC, Hibernate, MyBatis 等 DAO 层 支持 ， 本 节 介 绍 DAO 
模块 对 JDBC 的 支持 。DAO 模块 依赖 commons-dbcp.jar、commons-pool.jar。 


5.2.1 JdbcDaoSupport 的 使 用 


传统 的 JDBC 需要 创建 连接 、 打 开 、 执 行 SQL、 关 闭 连接 这 一 系列 步骤 。Spring 框架 对 
JDBC 进 行 了 封装 ,我 们 只 需 使 用 封装 好 的 JdbcTemplate 执 行 SQL 语句 。 既 然 是 JdbcDaoSupport 
的 使 用 ， 为 什么 是 使 用 JdbcTemplate 呢 ? 因为 JdbcDaoSupport 提供 了 JdbcTemplate 对 象 ， 通 
过 JdbcTemplate 对 象 进行 数据 库 操作 。 可 以 转 到 定义 ， 查 看 JdbcDaoSupport、JdbcTemplate 
两 个 类 的 具体 实现 。 我 们 通过 下 面 的 例子 来 了 解 JdbcDaoSupport 的 使 用 , 这 里 还 是 使 用 JDBC 
章节 的 数据 库 daodemodb 和 表 t. user 信息 。 


第 一 步 ， 根 据 t user 表 信息 准备 Model 类 User， 定 义 id. name. age. money 属性 ， 并 声 
明 两 个 构造 函数 。 


package com.demo.model; 
public class User { 


GOverride 
public String toString() ( 


return "Id:"+this.getId()+" Name:"+this.getName()+" Age:"+ this. 
getAge()+" Money: "+this.getMoney (); 
} 
private int Id; 
private String Name; 
private int Age; 


private double Money; 


public User() 
{ 


) 
public User(String name, int age, double money) ( 
Name - name; 


Age - age; 
Money - money; 
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public int getId() { 
return Id; 


public void setId(int id) { 
Id = id; 


public String getName() { 
return Name; 


public void setName(String name) { 
Name = name; 


public int getAge() { 
return Age; 


public void setAge(int age) { 
Age = age; 


public double getMoney() { 
return Money; 


public void setMoney(double money) { 
Money = money; 


) 


第 二 步 ， 定 义 接口 类 IUserDAO， 在 接口 中 声明 两 个 方法 : QueryAllUser 方法 属于 查询 操 
作 ， 查 询 所 有 User; AddUser 属于 更 新 操作 ， 新 增 User. 


package com.demo.model; 
import java.util.*; 
public interface IUserDAO { 


public List<User>QueryAllUser (); 
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public Boolean AddUser (User user); 


} 


第 三 步 ， 就 是 IdbcDaoSupport 的 使 用 了 。 在 下 面 的 SpringDAODemo 类 中 首先 继承 
JdbcDaoSupport， 同 时 实现 IUserDAO 接口 中 的 方法 。JdbcDaoSupport 提供 了 JdbcTemplate 对 
&, SpringDAODemo 继承 了 JdbcDaoSupport， 所 以 也 就 可 以 直接 获取 到 JdbcTemplate 对 象 ， 
然后 执行 该 对 象 的 方法 进行 数据 库 操作 。 


package com.demo.model; 
import java.util.*; 


import org.springframework.beans.factory.BeanFactory; 

import org.springframework.context.ApplicationContext; 

import org.springframework.context.support. 
ClassPathXmlApplicationContext; 

import org.springframework.jdbc.core.support.JdbcDaoSupport; 


public class SpringDAODemo extends JdbcDaoSupport implements IUserDAO ( 


public static void main(String[] args) ( 
ApplicationContext context-new ClassPathXmlApplicationContext (new 
String[]("ApplicationContext.xml"]); 
BeanFactory factory-context; 
IUserDAO userDao=(IUserDAO) factory.getBean ("userDao") ; 
User user=new User ("JdbcDaoSupportTest", 26, 333.33); 
userDao.AddUser (user) ; 
List<User> list-userDao.QueryAllUser(); 
for (User u:list) 
{ 
System. out.println(u.toString()); 


public List<User> QueryAllUser() { 
String sql="select id,name,age,money from t_user order by id desc"; 
List<Map<String,Object>> list=getJdbcTemplate() .queryForList (sql); 
List<User> userList=new ArrayList<User>(); 
for (Map<String,Object> row:list) 
{ 
User user=new User (); 
user.setId( (Integer) row.get ("id") ); 
user.setName ( (String) row.get ("name") ); 
user.setAge ( (Integer) row.get ("age") ); 
user.setMoney (Double.parseDouble(row.get ("money") .toString())); 
userList.add (user) ; 
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return userList; 


public Boolean AddUser(User user) { 
String sql="insert into t user (name,age,money) values (?,?,?)"; 
int row=getJdbcTemplate().update(sql, new Object[] {user.getName(), 
user.getAge(),user.getMoney () })7 
if (row>0) 
{ 
System.out.println(" 数 据 新 增 成 功 !") ; 
return true; 
H 
return false; 


) 


第 四 步 ， 配 置 属性 。 在 上 面 的 main 方法 中 先 通过 上 下 文 获取 到 bean 对 象 ， 然后 执行 新 增 
操作 和 查询 操作 。 但 是 上 面 的 代码 并 未 看 到 数据 库 信息 , 这 里 还 需要 在 ApplicationContextxml 
中 配置 数据 库 信息 ， 并 为 IdbcDaoSupportDemo 设置 数据 源 。 为 什么 会 有 dataSource 属性 呢 ? 
因为 JdbcDaoSupport 中 包含 这 个 属性 。 


<?xml version="1.0" encoding-"UTF-8"?» 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:context-"http://www.springframework.org/schema/context" 
xmlns:mvc-"http://www.springframework.org/schema/mvc" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xmlns:aop-"http://www.springframework.org/schema/aop" 
xsi:schemaLocation-" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd 
http://www.springframework.org/schema/mvc 
http://www.springframework.org/schema/mvc/spring-mvc.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd 
> 
<bean id-"dataSource" class="org.apache.commons.dbcp.BasicDataSource"> 

<property name="driverClassName"> 

<value>com.mysql .jdbc.Driver</value> 
</property> 
<property name="url"> 
<value>jdbc:mysql://127.0.0.1:3306/daodemodb</value> 
</property> 
<property name="username"> 
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<value>root</value> 
</property> 
<property name="password"> 
<value>123456</value> 

</property> 
</bean> 
<bean id-"userDao" class-"com.demo.model.SpringDAODemo" 

depends-on="dataSource"> 
<property name-"dataSource" ref="dataSource"></property> 

</bean> 
</beans> 


BLA, pom.xml 中 配置 的 依赖 信息 。 例 子 是 Spring 中 DAO 的 实现 , 而 且 是 对 jdbe 的 封 
装 ， 所 以 包含 Spring 相关 依赖 和 jdbc 的 相关 依赖 。 


<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
«modelVersion»4.0.0«/modelVersion» 
<groupId>com. demo</groupId> 
<artifactId>SpringDAO</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<properties> 
<project. build. sourceEncoding>UTF-8</project.build.sourceEncoding> 
<spring.version>5.0.0.RELEASE</spring.version> 
</properties> 
<dependencies> 
<dependency> 
<groupId>org. springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>${spring.version}</version> 
</dependency> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 
<version>${spring.version}</version> 
</dependency> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-jdbc</artifactId> 
<version>${spring.version}</version> 
</dependency> 
<dependency> 
XgroupId»commons-dbcp«/groupId» 
<artifactId>commons-dbcp</artifactId> 
<version>1.4</version> 
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</dependency> 

<dependency> 
<groupId>commons-pool</groupId> 
<artifactId>commons-pool</artifactId> 
<version>1.6</version> 

</dependency> 


<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java 


<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>5.1.6</version> 
</dependency> 
</dependencies> 
</project> 


运行 SpringDAODemo， 可 以 发 现 数据 库 和 打印 结果 中 增加 了 一 条 记录 。 


信息 ; Loading XML bean definitions from class path 
数据 新 增 成 功 ! 


Id:1 Name: JdbcDaoSupportTest Age:26 Money:333.33 


5.2.2 MappingSqlQuery 的 使 用 


在 JdbcDaoSupport 获取 所 有 User 的 方法 QueryAllUser() 中 ， 使 用 getJdbcTemplate(). 
queryForList() 返 回 的 是 List<Map<String,Object>> 类 型 , 需要 遍历 转换 成 Java 对 象 。 问题 来 了 ， 
查询 的 不 止 这 一 个 方法 ， 可 能 以 后 会 有 条 件 查询 的 方法 ， 每 次 都 要 把 从 数据 库 返 回 的 
List<Map<String,Object>> 类 型 的 List 转 一 遍 ， 当 然 也 可 以 专门 写 一 个 转换 的 方法 ， 这 样 每 次 
传 List<Map<String.Object>> 类 型 的 参数 ， 然 后 返回 List<User> 类 型 的 值 。 其 实 还 有 一 种 方式 ， 
就 是 使 用 MappingSqlQuery。MappingSqlQuery 是 一 个 抽象 类 ， 需 要 实现 它 的 方法 mapRow(). 

第 一 步 ,实现 MappingSqlQuery 抽象 类 ,这 里 在 UserMappingSqlQuery 类 中 实现 了 mapRow() 
方法 。 

package com.demo.model; 


import java.sql.ResultSet; 
import java.sql.SQLException; 


import org.springframework. jdbc.object .MappingSqlQuery; 


public class UserMappingSqlQuery extends MappingSqlQuery<User>{ 


@Override 

protected User mapRow(ResultSet rs, int rowNum) throws SQLException { 
User user=new User(); 
user.setId( (Integer) rs.getInt ("id") ); 
user.setName ( (String) rs.getString ("name") ); 
user.setAge ( (Integer) rs.getInt ("age") ); 
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user.setMoney ( (Double) rs.getDouble ("money") ) ; 
return user; 


) 


第 二 步 , UserMappingSqlQuery 类 的 使 用 ,这 里 重 写 SpringDAODemo 类 中 的 QueryAllUser() 
方法 。UserMappingSqlQuery 需要 传 入 DataSource 和 sql， 并 执行 compile() 编 译 。 这 里 通过 
getDataSource() 获 取 的 是 JdbcDaoSupport 的 DataSource 属性 。 如 果 有 参数 ， 可 以 使 用 
setParametersO) 设 置 参数 ， 下 面 的 代码 为 了 演示 设置 参数 ， 增 加 了 where 1-1 的 查询 条 件 。 


public List<User> QueryAllUser() { 
String sql="select id,name,age,money from t_user where ?"; 
UserMappingSqlQuery userQuery-new UserMappingSqlQuery (); 
userQuery.setDataSource (getDataSource()); 
userQuery.setSql (sql); 
userQuery.setParameters (new SqlParameter(java.sql.Types.VARCHAR)); 
userQuery.compile(); 
return userQuery.execute (new Object[] (new String("1-1")]); 

) 


5.2.3 SqlUpdate 的 使 用 


SqlUpdate 主要 用 来 更 新 ， 可 以 设置 参数 。SqlUpdate 可 以 将 某 个 功能 模块 化 。 通 过 下 面 的 
例子 来 了 解 一 下 SqlUpdate 的 使 用 。 


package com.demo.model; 
import javax.sql.DataSource; 


import org.springframework.beans.factory.BeanFactory; 

import org.springframework.context.ApplicationContext; 

import org.springframework.context.support. 
ClassPathXmlApplicationContext; 

import org.springframework.jdbc.core.SqlParameter; 

import org.springframework.jdbc.object.SqlUpdate; 


public class UserSqlUpdate extends SqlUpdate( 
public static void main(String[] args) ( 


ApplicationContext context-new ClassPathXmlApplicationContext (new 
String[]("ApplicationContext.xml"]); 
BeanFactory factory-context; 
UserSqlUpdate userSqlUpdate=(UserSqlUpdate) factory.getBean 
("userSqlUpdate") ; 
userSqlUpdate.updateUserMoney ("小 李 ", 666.66) ; 
H 


public UserSqlUpdate (DataSource ds) ( 
setDataSource (ds) ; 
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setSql ("update t user set money-? where name-?"); 
declareParameter (new SqlParameter(java.sql.Types.DOUBLE) ); 
declareParameter (new SqlParameter(java.sql.Types.VARCHAR) ); 
compile(); 


H 


public Boolean updateUserMoney (String name,double money) 
I 
int row- update (new Object[] (new Double (money),new String (name)]); 
if (row>0) 
f 
System.out.Println(" 数 据 新 增 成 功 !") ; 
return true; 
} 
return false; 


} 
在 ApplicationContext.xml 中 配置 userSqlUpdate 对 应 的 bean 节点 。 


<bean id-"userSqlUpdate" class="com.demo.model.UserSqlUpdate"> 
<constructor-arg ref="dataSource" index="0"></constructor-arg> 
</bean> 


在 上 面 的 UserSqlUpdate 中 继承 了 SqlUpdate, 383 setDataSource. setSql 分 别 设置 
SqlUpdate 的 数据 源 和 要 执行 的 SQL。 在 main 方法 中 将 name 为 小 李 的 money 修改 为 666.66， 
执行 main 方法 之 后 会 打印 出 “数据 新 增 成 功 ! ”， 数 据 库 中 小 李 的 money 改 成 了 666.66。 


5.2.4 SqlFunction 的 使 用 


SqlFunction 返回 单一 行 的 查询 结果 ， 默 认 返 回 int， 也 可 以 重 载 返回 其 他 类 型 。 下 面 直接 
在 main 函数 中 使 用 。 


public static void main(String[] args) { 


ApplicationContext context=new ClassPathXmlApplicationContext (new 
String[]("ApplicationContext.xml"]); 

BeanFactory factory-context; 

BasicDataSource dataSource=(BasicDataSource) factory. 
getBean ("dataSource") ; 

SqlFunction sf-new SqlFunction(dataSource,"select count(1) from 
t user;"); 

sf.compile(); 

int count-sf.run(); 

System.out.println("User Count:"+count) ; 
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Spring 事务 管理 


至 于 什么 是 事务 , 在 JDBC 章节 已 经 介绍 , 这 里 就 不 再 说 了 。JDBC 中 有 事务 管理 , Spring 
使 用 DataSourceTransactionManager 作为 JDBC 的 事务 管理 者 ， 同 时 把 被 管理 的 对 象 使 用 
TransactionProxyFactoryBean 配置 。 从 名 字 也 能 猜 出 这 里 使 用 的 设计 模式 是 代理 设计 模式 。 这 
是 一 个 事务 代理 Bean， 能 够 使 用 IOC、AOP 等 注入 事务 管理 代码 。 在 JDBC 中 介绍 事务 时 用 
的 是 转账 操作 ， 这 里 为 了 更 好 理解 ， 还 是 使 用 转账 操作 。 

(1) 在 IUserDAO 接口 中 增加 转账 方法 transfer。 


public Boolean transfer (int fromUserId, int toUserId, float transferMoney) ; 


(2) f£ SpringDAODemo 类 中 实现 transfer. M fromUserld 这 个 用 户 转 账 到 toUserld 这 个 
FAP, outInMoney 方法 就 是 执行 SQL 更 新 数据 库 用 户 的 money。 这 里 如 果 人 为 制造 一 个 异常 ， 
把 “int 二 1/0; ”这 行 注释 取消 ， 就 会 在 后 面 执行 转账 时 自动 回 深 ， 转 账 不 会 成 功 。 


public Boolean transfer (int fromUserId, int toUserId, float transferMoney) { 


Boolean out= outInMoney (fromUserId,-transferMoney); 
//int i-1/0; // 事 务 回 滚 


Boolean in=outInMoney (toUserId,transferMoney); 


return out&in; 


) 
private Boolean outInMoney (int toUserId,float money) 
{ 
String sql="update t_user set money=money+? where id=? "; 
int row=getJdbcTemplate().update(sql, new Object[] {money, toUserId}) ; 
if (row>0) 
{ 
return true; 
H 
return false; 
} 


(3) 配置 事务 ， 在 ApplicationContext.xml 中 配置 事务 管理 对 象 DataSourceTransaction- 
Manager， 设 置 事务 代理 对 象 TransactionProxyFactoryBean 。 


<bean id-"transactionManager" class="org.springframework.jdbc.datasource. 
DataSourceTransactionManager"> 
<property name-"dataSource" ref="dataSource"/> 
</bean> 


<!-- 配置 业务 层 代理 --> 
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<bean id-"userDaoProxy" class-"org.springframework.transaction. 
interceptor.TransactionProxyFactoryBean"» 
<!-- 配置 目标 对 象 --> 
<property name-"target" ref="userDao"/> 
<!-- 注入 事务 管理 器 --> 
<property name-"transactionManager" ref="transactionManager"/> 
<!-- 注入 事务 的 属性 --> 
<property name="transactionAttributes"> 
<props> 
<prop key="transfer">PROPAGATION_REQUIRED</prop> 
</props> 
</property> 
</bean> 


(4) 执行 转账 操作 ， 在 main 方法 中 执行 transfer 方法 ， 为 用 户 1. 2 进行 转账 。 如 果 在 
transfer 方法 中 人 为 制造 的 异常 被 注释 ， 是 可 以 正常 转账 的 ， 取 消 注 释 则 转账 失败 ， 打 印 “ 事 


public static void main(String[] args) { 
ApplicationContext context=new ClassPathXmlApplicationContext (new 
String[]("ApplicationContext.xml"]); 
BeanFactory factory-context; 
IUserDAO userDao- (IUserDAO)factory.getBean("userDaoProxy"); 
try 
t 
userDao.transfer(1, 2, 100); 
) 
catch(Exception e) 
{ 
System. out.print1n ("#3 ER"); 


5.4 小 结 


本 章 主 要 介绍 了 JDBC 的 使 用 以 及 Spring DAO 模块 对 JDBC 的 封装 ,Spring DAO 模块 通 
过 使 用 JdbcDaoSupport、SqlUpdate 等 对 象 隐藏 了 Connection Statement, ResultSet “ JDBC API, 
而 且 可 以 比较 灵活 地 配置 事务 管理 。 通 过 本 章 的 学 习 ， 对 后 面 学 习 ORM 知识 也 打下 基础 。 
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< MyBatis 快 速 入 门 > 


在 上 一 章节 中 ,我 们 了 解 了 Spring 框架 中 的 DAO 模块 ， 这 一 章 我 们 将 开始 学 习 ORM 框架 中 
常用 的 一 


个 框架 一 一 MyBatis。 


本 章 主要 涉及 的 知识 点 : 


MVC 框架 : properties, environments, settings 等 属性 的 配置 。 
XML 映射 文件 : 增删 改 查 映射 、 参 数 、 数 据 集 的 映射 。 
缓存 : 一 级 、 二 级 缓存 及 自 定义 缓存 。 

动态 SQL: 动态 SQL 的 使 用 。 

逆向 工程 : 使 用 逆向 工程 自动 生成 配置 文件 

分 页 插件 的 使 用 : 了 解 分 页 插件 pagehelper 的 简单 使 用 。 


ORM 框架 介绍 


MyBatis 是 一 种 ORM 框架 ， 在 学 习 MyBatis 之 前 我 们 需要 了 解 ORM 框架 是 什么 以 及 为 
什么 会 有 ORM 框架 。 


6.1.1 


ORM 框架 简介 


ORM (Object Relation Mapping， 对 象 关系 映射 ) 是 一 种 为 了 解决 面向 对 象 与 关系 数据 库 
存在 的 互 不 匹配 的 现象 的 技术 。 通 过 使 用 描述 对 象 和 数据 库 之 间 映 射 的 元 数据 , 将 程序 中 的 对 
PESIN EN 
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E 第 5 章 学 习 的 JDBC 和 Spring 的 DAO 都 可 以 进行 数据 持久 化 操作 。 那 为 什么 还 需要 


ORM 框架 呢 ? 对 于 SQL Server. MySQL. Oracle 等 这 些 传统 的 数据 库 ， 基 本 都 是 关系 型 数据 
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是 体现 实体 与 实体 之 间 的 联系 ， 在 以 前 开发 时 ， 可 能 先 根据 需求 设计 数据 库 ， 然 后 写 


Model 和 业务 逻辑 , 对 于 Model 类 基本 都 是 和 表 的 字段 对 应 , 而 表 中 存 的 每 条 记录 又 和 类 的 实 
例 对 象 对 应 着 。 有 了 这 个 对 照 关 系 ， 就 是 能 不 能 只 在 一 边 设计 ， 在 数据 库 设计 表 或 在 VS 中 设 
it Model， 然 后 直接 生成 另 一 边 ,这样 就 省 了 好 多 时 间 成 本 , 于 是 有 了 ORM。 可 以 根据 Model 
生成 数据 库 ， 也 可 以 由 数据 库 生成 Model，Model、 数 据 库 是 分 离 的 ， 我 们 也 可 以 根据 Model 
AE MAS FF] RAY (MySQL, SQL Server. Oracle) 数据 库 , 不 同类 型 的 数据 库 (MySQL、 SQL Server, 
Oracle) 也 可 以 生成 同样 的 Model， 而 它们 共同 的 纽带 就 是 Mapping。 
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6.1.2. MyBatis 框架 介绍 


Java 最 常用 的 ORM 中 间 件 有 Hibernate 和 MyBatis。 两 个 框架 都 有 各 自 的 优 劣 势 ,Hibernate 
学 习 门 槛 不 低 ， 要 精通 门槛 更 高 , 为 了 能 方便 快速 入 门 , 这 里 主要 介绍 MyBatis。 有 了 MyBatis 
基础 ， 对 ORM 思想 有 了 进一步 的 认识 之 后 再 学 习 Hibernate 也 会 相对 容易 一 些 。 

我 们 经 常 也 会 看 到 iBatis， 其 实 它 和 MyBatis 是 同一 个 东西 ，MyBatis 本 是 Apache 的 一 个 
开源 项 目 iBatis, 2010 年 这 个 项 目 由 Apache Software Foundation 迁移 到 了 Google Code, 并 且 
改名 为 MyBatis。iBatis 一 词 来 源 于 “internet” 和 “abatis” 的 组 合 ， 是 一 个 基于 Java 的 持久 层 
框架 ,iBatis 提供 的 持久 层 框 架 包 括 SQL Maps 和 Data Access Objects(DAO)。MyBatis 是 iBatis 
的 升级 版 ，MyBatis 实现 了 接口 绑 定 ， 使 用 更 加 方便 ， 对 象 关系 映射 进行 了 改进 ， 效 率 更 高 ， 
采用 功能 强大 的 基于 OGNL 的 表达 式 来 消除 其 他 元 素 。 

MyBatis 是 一 款 优秀 的 持久 层 框架 ， 支 持 定制 化 SQL、 存 储 过 程 以 及 高 级 映射 ，MyBatis 
避免 了 几乎 所 有 的 JDBC 代码 和 手动 设置 参数 以 及 获取 结果 集 ， 可 以 使 用 简单 的 xml 或 注解 
来 配置 和 映射 原生 信息 ， 将 接口 和 Java 的 POJOs 映射 成 数据 库 的 记录 。 

MyBatis 有 以 下 特点 : 


CD 简单 易学 。 没 有 任何 第 三 方 依赖 ， 只 需要 两 个 jar 包 + 几 个 SQL 映射 文件 ， 通 过 文 
档 和 源 代 码 ， 即 可 比较 完全 地 掌握 它 的 设计 思路 和 实现 。 

(2) 灵活 。 不 会 对 应 用 程序 或 者 数据 库 的 现 有 设计 强加 任何 影响 。SQL 写 在 xml 里 面 ， 
便于 统一 管理 和 优化 。 通 过 SQL 基本 上 可 以 实现 不 使 用 数据 访问 框架 就 能 实现 的 所 有 功能 。 

(3) 解除 SQL 与 程序 代码 的 耦合 。 通 过 提供 DAL 层 , 将 业务 逻辑 和 数据 访问 逻辑 分 离 ， 
使 系统 的 设计 更 清晰 、 更 易 维 护 、 更 易于 单元 测试 。 

(4) 提供 映射 标签 ， 支 持 对 象 与 数据 库 的 ORM 字段 关系 映射 。 

(5) 提供 对 象 关系 映射 标签 ， 支 持 对 象 关 系 组 建 维护 。 

(6) 提供 xml 标签 ， 支 持 编写 动态 SQL. 


6.1.3 MyBatis AT] 


使 用 JDBC 时 也 有 一 些 固定 的 步骤 流程 ,而且 每 个 步骤 流程 都 或 多 或 少 对 应 着 对 象 。 有 时 
候 面试 官 也 会 经 常 问 类 似 某 某 知 识 点 〈(JDBC) 有 几 大 对 象 ， 如 果 掌 握 了 它 使 用 的 步骤 流程 ， 
就 很 容易 记 住 有 哪 几 个 对 象 。MyBatis 的 使 用 与 JDBC 类 似 ， 也 有 一 些 固定 的 步骤 流程 。 所 以 
学 习 MyBatis 需要 先 了 解 一 下 它 的 使 用 流程 。 


1. 安装 
使 用 MyBatis 需要 先 引入 MyBatis 对 应 的 依赖 , 同时 需要 操作 数据 库 ， 所 以 也 需要 引入 数 
据 库 对 应 的 依赖 ， 这 里 使 用 的 是 MySQL 数据 库 连接 依赖 。 


<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> 
<dependency> 
<groupId>org.mybatis</groupId> 
<artifactId>mybatis</artifactId> 
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<version>3.4.6</version> 
</dependency> 
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java --> 
<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>5.1.6</version> 
</dependency> 


2. 构建 SqlSessionFactory 


获取 SqlSessionFactory 与 在 第 3 章 获 取 Beanfactory 对 象 有 点 类 似 。Beanfactory 对 象 通过 
ApplicationContext.xml 配置 文件 获取 。 每 个 基于 MyBatis 的 应 用 都 是 以 一 个 SqlSessionFactory 
实例 为 中 心 的 。 SqlSessionFactory 实例 可 以 通过 SqlSessionFactoryBuilder 获得 。 
SqlSessionFactoryBuilder 可 以 从 XML 配置 文件 或 一 个 预先 定制 的 Configuration 实例 构建 出 
SqlSessionFactory 实例 。 
从 XML 文件 中 构建 SqlSessionFactory 的 实例 非常 简单 ， 建议 使 用 类 路 径 下 的 资源 文件 进 
行 配置 ， 但 是 也 可 以 使 用 任意 的 输入 流 (InputStream) 实例 ， 包 括 字符 串 形式 的 文件 路 径 或 者 
file//ff) URL 形式 的 文件 路 径 .MyBatis 包含 一 个 名 叫 Resources 的 工具 类 , 包含 一 些 实用 方法 ， 
可 使 从 classpath 或 其 他 位 置 加 载 资 源 文件 更 加 容易 。 
String resource = "mybatis-config.xml"; 
// 使 用 MyBatis 提供 的 Resources 类 加 载 mybatis 的 配置 文件 (也 加 载 关联 的 映射 文件 ) 
Reader reader = Resources.getResourceAsReader (resource); 
// 构 建 sqlSession 的 工厂 
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder(). 
build (reader); 
XML 配置 文件 (configuration XML) 中 包含 了 对 MyBatis 系统 的 核心 设置 ， 包 含 获取 数 
据 库 连接 实例 的 数据 源 〈DataSource ) 和 决定 事务 作用 域 和 控制 方式 的 事务 管理 器 
CTransactionManager) , XML 配置 文件 会 在 后 面 的 章节 详细 介绍 。 


3. 获取 SqlSession 


既然 有 了 SqlSessionFactory， 顾 名 思 义 ， 我 们 就 可 以 从 中 获得 SqlSession 的 实例 了 。 
SqlSession 完全 包含 了 面向 数据 库 执行 SQL 命令 所 需 的 所 有 方法 。 你 可 以 通过 SqlSession 实例 
来 直接 执行 已 映射 的 SQL 语句 。 这 里 先 通过 下 面 的 例子 来 了 解 MyBatis 的 使 用 。 

4. 实例 演示 

实例 还 是 使 用 上 一 章节 用 到 的 daodemodb 数据 库 、t_user 表 以 及 User 对 象 。 这 里 就 不 再 
列 出 了 。 

(1) pom.xml 引入 依赖 库 , 主要 引入 mybatis 依赖 和 mysql-connector-javaMySql 数据 库 连 

接 依赖 。 


<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> 
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<dependency> 
XgroupId»org.mybatis«/groupId» 
<artifactId>mybatis</artifactId> 
<version>3.4.6</version> 

</dependency> 

<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java --> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>5.1.6</version> 

</dependency> 


(2) 准备 配置 文件 。SqlSessionFactory 对 象 是 通过 XML 配置 文件 构建 的 ， 所 以 需要 先 准 
备 配 置 文件 ， 主 要 包含 两 个 ,一 个 是 映射 配置 文件 ， 另 一 个 是 MyBatis 配置 文件 。 配 置信 息 具 
体 含义 可 以 先 不 用 在 意 ， 后 面 会 详细 介绍 。 

UserMapper.xml 文件 配置 的 是 SQL 语句 与 实体 类 的 映射 。 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http: //mybatis.org/dtd/mybatis-3-mapper.dtd"> 

<mapper namespace="com.demo.mybatis.DBMapping.UserMapper"> 

<select id="getUserList" resultType="com.demo.model.User"> 
select * from t_user 

</select> 

</mapper> 


mybatis-config.xml 这 里 配置 了 数据 库 的 连接 信息 以 及 SQL 的 mappers 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http: //mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<environments default="development"> 
<environment id="development"> 
<transactionManager type="JDBC" /> 
<!-- 配置 数据 库 连接 信息 --> 
<dataSource type="POOLED"> 
<property name-"driver" value-"com.mysql.jdbc.Driver" /> 
<property name-"url" value-"jdbc:mysql://127.0.0.1:3306/ 


daodemodb"/» 
Xproperty name-"username" value-"root" /» 
Xproperty name-"password" value-"123456" /» 
«/dataSource» 
</environment> 

</environments> 

<!-- 程序 中 所 用 到 sql 映射 文件 都 在 这 里 列 出 ， 这 些 映 射 sql 都 被 MyBatis 管理 --> 

<mappers> 
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<mapper resource="com/demo/mybatis/DBMapping/UserMapper.xml" /> 
</mappers> 
</configuration> 


(3) 通过 准备 好 的 配置 文件 构建 SqlSessionFactory， 获 取 到 能 执行 映射 文件 中 SQL 的 
SqlSession， 然 后 执行 SQL 输出 t_user 表 中 所 有 的 用 户 信息 。 


public class BasicDemo { 
public static void main( String[] args ) throws IOException 
{ 
String resource = "mybatis-config.xml"; 
// 使 用 MyBatis 提供 的 Resources HMR mybatis 的 配置 文件 (也 加 载 关联 的 映射 文件 ) 
Reader reader = Resources.getResourceAsReader (resource); 
// 构 建 sqlSession 的 工厂 
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder(). 
build(reader); 
// 创 建 能 执行 映射 文件 中 sql 的 sqlSession 
SqlSession session = sessionFactory.openSession(); 
String statement="com.demo.mybatis.DBMapping.UserMapper. 
getUserList"; 
List<User>users=session.selectList (statement) ; 
for (User u: users) { 
System. out.println(u.toString()); 
} 


} 


通过 上 面 的 一 个 查询 用 户 表 信息 的 demo， 基 本 了 解 了 MyBatis 的 使 用 过 程 ， 下 面 详细 了 
解 一 下 XML 配置 的 详细 内 容 。 


5.2 xML 配置 


MyBatis 的 配置 文件 包含 了 会 深 深 影响 MyBatis 行为 的 设置 (settings) 和 属性 (properties) 
信息 。 在 上 面 MyBatis 实例 中 mybatis-config.xml 只 是 配置 了 environments 信息 ， 比 较 简 单 ， 
本 节 详 细 了 解 一 下 MyBatis 的 配置 。 


6.2.1 properties 属性 
属性 都 是 可 外 部 配置 且 可 动态 替换 的 ， 既 可 以 在 典型 的 Java 属性 文件 中 配置 ， 亦 可 通过 
properties 元 素 的 子 元 素来 传递 。 上 面 <dataSource> 配 置 中 的 属性 就 可 以 先 配 置 在 properties 元 


素 中 。 这 里 在 resource 包 中 增加 了 database.properties 文件 , 在 database.properties 设置 了 driver 
和 url 属性 。 


93 


Spring 快速 入 门 


driver-com.mysql.jdbc.Driver 
url-jdbc:mysql://127.0.0.1:3306/daodemodb 


在 mybatis-config.xml 中 增加 properties 元 素 ， 这 里 通过 resource 引入 database.properties 


文件 中 的 属性 ， 同 时 设置 username 和 password 两 个 属性 。 


<properties resource="database.properties"> 
<property name="username" value="root"/> 
<property name-"password" value="123456"/> 
</properties> 


有 了 这 些 属性 之 后 , 就 可 以 将 上 面 dataSource 元 素 的 配置 进行 修改 , 不 用 写成 固定 值 ， 而 


是 写成 属性 值 ,这 样 做 有 什么 好 处 呢 ? 其 实 有 些 属性 可 能 不 止 一 个 地 方 会 用 到 , 一 个 地 方 设置 ， 
多 个 地 方 引用 ， 这 样 后 续 维 护 也 会 更 方便 一 些 。 


<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"» 
«configuration» 
«properties resource="database.properties"> 
<property name-"username" value="root"/> 
<property name-"password" value="123456"/> 
</properties> 
<environments default="development"> 
<environment id="development"> 
<transactionManager type="JDBC" /> 
<!-- 配置 数据 库 连接 信息 --> 
<dataSource type="POOLED"> 
<property name="driver" value="${driver}" /> 
<property name-"url" value="${url}" /> 
<property name="username" value="${username}" /> 
<property name="password" value="${password}" /> 
</dataSource> 
</environment> 
</environments> 
<!-- 程序 中 所 用 到 sql 映射 文件 都 在 这 里 列 出 ， 这 些 映 射 sql 都 被 MyBatis 管理 --> 
<mappers> 
<mapper resource-"com/demo/mybatis/DBMapping/UserMapper.xml" /> 
</mappers> 
</configuration> 


这 里 username 和 password 将 会 由 properties 元 素 中 设置 的 相应 值 来 蔡 换 。driver 和 url 属 


性 将 会 由 database.properties 文件 中 对 应 的 值 来 蔡 换 ， 这 样 也 为 配置 提供 了 诸多 灵活 选择 。 
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如 果 属 性 在 不 止 一 个 地 方 进行 了 配置 ， 那 么 MyBatis 将 按照 下 面 的 顺序 来 加 载 : 
(1) 在 properties 元 素 体内 指定 的 属性 首先 被 读 取 。 
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(2) 根据 properties 元 素 中 的 resource 属性 读 取 类 路 径 下 属性 文件 或 根据 url 属性 指定 的 
路 径 读 取 属 性 文件 ， 并 覆盖 已 读 取 的 同名 属性 。 
(3) 读 取 作为 方法 参数 传递 的 属性 ， 并 覆盖 已 读 取 的 同名 属性 。 


因此 ， 通 过 方法 参数 传递 的 属性 具有 最 高 优先 级 ，resource/url 属性 中 指定 的 配置 文件 次 
之 ， 最 低 优先 级 的 是 properties 属性 中 指定 的 属性 。 


6.2.2 settings 


settings 是 MyBatis 中 极为 重要 的 调整 设置 ,它们 会 改变 MyBatis 的 运行 时 行为 。 表 6-1 
给 出 设置 中 各 项 的 意图 、 默 认 值 等 。 


表 6-1 settings 各 项 的 意图 、 默 认 值 


ETT CENE" 


M 全 局 地 开启 或 关闭 配置 文件 中 的 所 有 映射 
es 器 已 经 配置 的 任何 缓存 lan i 


延迟 加 载 的 全 局 开关 。 当 开启 时 ， 所 有 关 
联 对 象 都 会 延迟 加 载 。 特 定 关联 关系 中 可 
通过 设置 fetchType 属性 来 覆盖 该 项 的 开 
关 状 态 

当 开启 时 ， 任 何方 法 的 调用 都 会 加 载 该 对 
aggressiveLazyLoading 象 的 所 有 属性 。 否 则 ， 每 个 属性 会 按 需 加 
载 (参考 lazyLoadTriggerMethods) 

是 否 允许 单一 语句 返回 多 结果 集 TEE 
容 驱 动 ) 

使 用 列 标签 代替 列 名 。 不 同 的 驱动 在 这 方 
面 会 有 不 同 的 表现 ， 具 体 可 参考 相关 驱动 
文档 ， 或 通过 测试 这 两 种 不 同 的 模式 来 观 
察 所 用 驱动 的 结果 

允许 JDBC 支持 自动 生成 主键 , 需要 驱动 
兼容 。 如 果 设 置 为 true， 那 么 这 个 设置 强 
制 使 用 自动 生成 主键 ， 尽 管 一 些 驱动 不 能 
兼容 但 仍 可 正常 工作 (比如 Derby) 

指定 MyBatis 应 如 何 自动 映射 列 到 字段 或 
属性 。NONE 表示 取消 自动 映射 ; 
autoMappingBehavior PARTIAL 只 会 自动 映射 没有 定义 嵌 套 结 
果 集 映射 的 结果 集 ; FULL 会 自动 映射 任 
意 复杂 的 结果 集 CAREERS) 


lazyLoadingEnabled 


multipleResultSetsEnabled 


useColumnLabel 


useGeneratedKeys 
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描 x 


( 续 表 ) 


autoMappingUnknown- 
ColumnBehavior 


指定 发 现 自动 映射 目标 未 知 列 〈 或 者 未 知 

属性 类 型 ) 的 行为 。 

© NONE: 不 做 任何 反应 

* WARNING: 输出 提醒 日 志 Corg. 
apache.ibatis.session.AutoMapping- 
UnknownColumnBehavior 的 日 志 等 级 
必须 设置 为 WARN) 

* FAILING: 映射 失败 〈 抛 出 SqlSession- 
Exception) 


defaultExecutorType 


配置 默认 的 执行 器 。SIMPLE 就 是 普通 的 
HUTS; REUSE 执行 器 会 重用 预 处 理 语 
名 (prepared statements) ; BATCH 执行 
器 将 重用 语句 并 执行 批量 更 新 


SIMPLE 
REUSE 
BATCH 


defaultStatementTimeout 


defaultFetchSize 


safeRowBoundsEnabled 


设置 超时 时 间 ， 决 定 驱动 等 待 数据 库 响应 
的 秒 数 

为 驱动 的 结果 集 获 取 数量 〈fetchSize) 设 
置 一 个 提示 值 。 此 参数 只 可 以 在 查询 设置 
中 被 覆盖 

允许 在 嵌 套 语句 中 使 用 分 页 (RowBounds) 。 
如 果 人 允许 使 用 就 设置 为 false 


任意 正 整数 


true | false 


Not Set (null) 


Not Set (null) 


safeResultHandlerEnabled 


fü Vr (E Mk ER 5) TRA OH 
(ResultHandler) 。 如 果 人 允许 使 用 就 设置 
为 false 


true | false 


mapUnderscoreToCamelCase 


localCacheScope 


是 否 开启 自动 驼峰 命名 规则 (camel case) 
映射 ， 即 从 经 典 数 据 库 列 名 A COLUMN 
到 经 典 Java 属性 名 aColumn 的 类 似 映射 

MyBatis 利用 本 地 缓存 机 制 (Local Cache) 
防止 循环 引用 (circular references) 和 加 速 
BAKE AW. SIMA SESSION, 这 种 
情况 下 会 缓存 一 个 会 话 中 执行 的 所 有 查 
询 。 若 设置 值 为 STATEMENT, 本 地 会 话 
仅 用 在 语句 执行 上 ， 对 相同 SqlSession 的 
不 同调 用 将 不 会 共享 数据 


SESSION | 
STATEMENT 


SESSION 


jdbcTypeForNull 
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当 没 有 为 参数 提供 特定 的 JDBC 类 型 时 ， 
为 空 值 指定 JDBC 类 型 。 某 些 驱 动 需要 指 
定 列 的 JDBC 类 型 ， 多 数 情 况 下 直接 用 一 
般 类 型 即 可 ， 比 如 NULL、VARCHAR 或 
OTHER 


JdbcType 常量 
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( 续 表 ) 
设置 参数 描 述 有 效 值 默 认 值 
用 逗号 分 隔 的 方 equals,clone, 


lazyLoadTriggerMethods 指定 哪个 对 象 的 方法 触发 一 次 延迟 加 载 法 列表 hashCode, 
toString 


org.apache.ibatis 
一 个 类 型 别名 或 | scripting xmltags. 
完全 限定 类 名 XMLLanguage 
Driver 


org.apache.ibatis 


defaultScripting Language 指定 动态 SQL 生成 的 默认 语 


defaultEnumTypeHandl 指定 Enum 使 用 的 默认 TypeHandler 一 个 类 型 别名 或 faa 
AMT | (345 开 始 ) 完全 限定 类 名 | areomp 
landler 


指定 当 结 果 集中 值 为 null 的 时 候 是 否 调用 
映射 对 象 的 setter (map 对 象 时 为 put) 方 
callSettersOnNulls 法 ， 这 对 于 有 Map.keySet() 依 赖 或 null 值 | true | false 
初始 化 的 时 候 是 有 用 的 。 注 意 基 本 类 型 

Cint, boolean 等 ) 是 不 能 设置 成 null 的 
当 返 回 行 的 所 有 列 都 是 空 时 ，MyBatis BK 
认 返 回 null。 当 开启 这 个 设置 时 ，MyBatis 
returnInstanceForEmptyRow | 会 返回 一 个 空 实例 。 注 意 ， 它 也 适用 于 骨 | true | false 
套 的 结果 集 Ge. collectioin and association ) 

(A 342 开始 ) 
指定 MyBatis 增加 到 日 志 名 称 的 前 级 


JAVASSIST 


指定 MyBatis 创建 具有 延迟 加 载 能 力 的 | CGLIB| 
proxyFactory ios ( MyBatis 3.3 
对 象 所 用 到 的 代理 工具 JAVASSIST 


orabove) 
HEN VFS 的 实 
指定 VFS 的 实现 现 的 类 全 限定 
名 ， 以 逗号 分 隔 


允许 使 用 方法 签名 中 的 名 称 作为 语句 参数 
useActualParamName 名 称 。 为 了 使 用 该 特 人 性， 你 的 工程 必须 采 true | false 
用 Java 8 编译 ， 并 且 加 上 -parameters 选项 
《从 34.1 开 始 ) 

指定 一 个 提供 Configuration 实例 的 类 。 这 
个 被 返回 的 Configuration 实例 用 来 加 载 被 
configurationFactory 反 序 列 化 对 象 的 懒 加 载 属性 值 。 这 个 类 必 
须 包含 一 个 签名 方法 static Configuration 
getConfiguration() (AA 3.2.3 版 本 开始 ) 


类 型 别名 或 者 全 
类 名 
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一 个 配置 完整 的 settings 元 素 的 示例 如 下 : 


<settings> 
<setting name="cacheEnabled" value="true"/> 
<setting name="lazyLoadingEnabled" value="true"/> 
<setting name="multipleResultSetsEnabled" value="true"/> 
<setting name-"useColumnLabel" value="true"/> 
<setting name="useGeneratedKeys" value="false"/> 
<setting name-"autoMappingBehavior" value="PARTIAL"/> 
<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/> 
<setting name-"defaultExecutorType" value="SIMPLE"/> 
<setting name="defaultStatementTimeout" value="25"/> 
<setting name="defaultFetchSize" value="100"/> 
<setting name="safeRowBoundsEnabled" value="false"/> 
<setting name="mapUnderscoreToCamelCase" value="false"/> 
<setting name-"localCacheScope" value="SESSION"/> 
«setting name-"jdbcTypeForNull" value="OTHER"/> 
«setting name-"lazyLoadTriggerMethods" value-"equals,clone,hashCode, 
toString"/» 
</settings> 


6.2.3 typeAliases 


类 型 别名 是 为 Java 类 型 设置 一 个 短 的 名 字 。 它 只 和 XML 配置 有 关 , 存在 的 意义 仅 在 于 用 
来 减少 类 完全 限定 名 的 宛 余 。 在 6.1.3 节 的 UserMapper.xml 文件 中 ， 设 置 resultType 时 用 的 是 
User 类 完全 限定 名 。 
<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 
<mapper namespace="com.demo.mybatis.DBMapping.UserMapper"> 
<select id-"getUserList" resultType="com.demo.model.User"> 
select * from t_user 
</select> 
</mapper> 


这 里 在 mybatis-config.xml 中 使 用 typeAliases 设置 com.demo.model.User 的 别名 为 User. 


<typeAliases> 
<typeAlias type="com.demo.model.User" alias="User"/> 
</typeAliases> 
有 了 别名 之 后 , 在 UserMapper.xml 中 用 到 com.demo.model.User 的 都 可 以 用 别名 代替 。 下 
面 的 xml 配置 中 将 resultType=com.demo.model.User HUR Y resultType=User。 有 一 点 需要 注意 ， 
别名 不 区 分 大 小 写 ，resultType=USER 或 user 都 是 可 以 的 。 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
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"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 
<mapper namespace="com.demo.mybatis.DBMapping.UserMapper"> 
<select id="getUserList" resultType="User"> 
select * from t_user 
</select> 
</mapper> 


通过 设置 别名 ， 减 少 了 类 完全 限定 名 的 元 余 ， 但 还 有 一 个 问题 ， 一 个 项 目 中 Java Bean 会 
很 多 ， 每 个 Java Bean 都 要 配置 一 次 ， 有 些 麻烦 ， 有 没有 进一步 简化 的 方法 呢 ? 答案 肯定 是 有 
的 。 可 以 指定 一 个 包 名 ，MyBatis 会 在 包 名 下 面 搜索 需要 的 Java Bean。 在 没有 注解 的 情况 下 ， 
会 使 用 Bean 的 非 限定 类 名 来 作为 它 的 别名 。 

<typeAliases> 


<package name-"com.demo.model"/» 
</typeAliases> 


若 有 注解 ， 则 别名 为 其 注解 值 。 这 里 在 User 类 设置 别名 为 users， 在 设置 resultType 时 可 
以 使 用 users 别名 。 


@Alias ("users") 
public class User { 


<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http: //mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.demo.mybatis.DBMapping.UserMapper"> 
<select id="getUserList" resultType="users"> 
select * from t_user 
</select> 
</mapper> 


6.2.4 typeHandlers 


1. 默认 类 型 处 理 器 


无 论 是 MyBatis 在 预 处 理 语句 (PreparedStatement) 中 设置 一 个 参数 ， 还 是 从 结果 集中 取 
出 一 个 值 ， 都 会 用 类 型 处 理 器 将 获取 的 值 以 合适 的 方式 转换 成 Java 类 型 。 这 个 转换 就 需要 使 
用 typeHandlers。 表 6-2 就 是 一 些 它 默认 自 带 的 类 型 处 理 器 。 


表 6-2 typeHandlers 默认 自 带 的 类 型 处 理 器 


类 型 处 理 器 Java 类 型 JDBC 类 型 
BooleanTypeHandler java.lang.Boolean, boolean AGERE AA BOOLEAN 


ByteTypeHandler | java.lang.Byte, byte 数据 库 兼 容 的 NUMERIC 或 BYTE 


ShortTypeHandler | java.lang.Short, short 数据 库 兼 容 的 NUMERIC 或 SHORT INTEGER 


IntegerTypeHandler java.lang. Integer, int 数据 库 兼 容 的 NUMERIC 或 INTEGER 
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(BR) 
类 型 处 理 器 Java 类 型 JDBC 类 型 
数据 库 兼容 的 NUMERIC 或 数据 库 兼容 的 
LONG INTEGER 
FloatTypeHandler java.lang Float float 数据 库 兼 容 的 NUMERIC 或 FLOAT 
DoubleTypeHandler java.lang.Double, double 数据 库 兼 容 的 NUMERIC 或 DOUBLE 
BigDecimalTypeHandler java.math. BigDecimal 数据 库 兼 容 的 NUMERIC 或 DECIMAL 
StringTypeHandler java.lang.String CHAR, VARCHAR 
ClobTypeHandler java.lang.String CLOB, LONGVARCHAR 
NStringTypeHandler java.lang.String NVARCHAR, NCHAR 
NClobTypeHandler java.lang.String NCLOB 
ByteArrayTypeHandler byte[] 数据 库 兼容 的 字 节 流 类 型 


BlobTypeHandler byte[] BLOB, LONGVARBINARY 


DateTypeHandler java.util.Date TIMESTAMP 


LongTypeHandler java.lang.Long, long 


DateOnlyTypeHandler java.util.Date DATE 


TimeOnlyTypetiander | javautil Date 


SqlTimestampTypeHandler | java.sql. Timestamp TIMESTAMP 


SqlDateTypeHandler java.sql. Date DATE 


VARCHAR， 任 何 兼容 的 字符 串 类 型 ， 存 储 枚 举 
的 名 称 〔 而 不 是 索引 ) 

任何 兼容 的 NUMERIC 或 DOUBLE 类 型 ， 存 储 
枚 举 的 索引 而 不 是 名 称 ) 

InstantTypeHandler java.time.Instant TIMESTAMP 


EnumTypeHandler Enumeration Type 


EnumOrdinalTypeHandler Enumeration Type 


LocalDateTimeTypeHandler | java.time.LocalDateTime TIMESTAMP 
LocalDateTypeHandler java.time.LocalDate 


LocalTimeTypeHandler java.time.LocalTime TIME 


OffsetDateTimeTypeHandler | java.time.OffsetDateTime TIMESTAMP 


OffsetTimeTypeHandler java.time.OffsetTime TIME 


ZonedDateTimeTypeHandler | java.time.ZonedDateTime TIMESTAMP 


YearTypeHandler java.time. Year INTEGER 


MonthTypeHandler java.time.Month INTEGER 


YearMonthTypeHandler java.time. YearMonth VARCHAR or LONGVARCHAR 


JapaneseDateT ypeHandler java.time.chrono.JapaneseDate | DATE 


针对 上 面 默 认 自 带 的 类 型 处 理 器 , 我 们 以 EnumTypeHandler. EnumOrdinalTypeHandler 为 
例 演 示 自 带 类 型 处 理 器 的 使 用 。 二 者 的 区 别 是 EnumTypeHandler 直接 存储 name 值 ， 而 
EnumOrdinalTypeHandler 会 存储 enum 类 里 的 序号 值 ， 此 时 数据 库 表 字段 一 般 用 int 类 型 的 处 
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。 我 们 来 看 一 下 EnumTypeHandler、EnumOrdinalTypeHandler 的 使 用 。 
这 里 为 了 演示 枚 举 类 型 ， 首 先 增加 一 个 枚 举 类 UserState。 


package com.demo.model; 

public enum UserState { 
DISABLED(0), 
AVAILABLE (1) ; 
private int status; 
UserState (int status) 
{ 


fezi 


this.status=status; 
} 
public int getStatus() 
i 


return status; 


} 


在 User 类 中 增加 一 个 UserState 类 型 的 属性 Status， 与 之 对 应 ， 在 数据 库 中 也 增加 一 个 字 
段 status, 由 于 EnumTypeHandler 直接 存储 name 值 , 而 EnumOrdinalTypeHandler 会 存储 enum 
类 里 的 序号 值 字段 类 型 ， 为 了 方便 把 字段 设置 成 了 varchar 类 型 。 

User 类 增加 属性 : 


private UserState Status; 


public UserState getStatus() { 
return Status; 


public void setStatus(UserState status) { 
Status = status; 
} 


t user 表 增 加 status 列 : 


ALTER TABLE "daodemodb'.^t user" 
ADD COLUMN ^states' VARCHAR(45) NULL AFTER "money'; 


下 面 要 面 对 的 问题 是 怎么 将 User 类 中 的 UserState 类 型 的 属性 Status 与 数据 库 t. user 表 的 
status 对 应 上 ， 两 个 互相 转换 的 问题 。 在 UserMapperxml 中 增加 了 两 个 操作 ， 一 个 是 新 增 用 户 
并 返回 用 户 自 增 id， 一 个 是 根据 用 户 id 查询 用 户 。 

<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
“http: //mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.demo.mybatis.DBMapping.UserMapper"> 
<select id-"getUserList" resultMap="userResult"> 
select * from t_user 
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</select> 
<insert id-"addUser" parameterType="user"> 
<selectKey resultType="java.lang.Integer" order="AFTER" 
keyProperty="id"> 
SELECT LAST_INSERT_ID() 
</selectKey> 
insert into t_user(name,age,money,status) values 


(#{name}, #{age}, #{money}, #{status, typeHandler=org.apache.ibatis.type.EnumTyp 
eHandler}) 


</insert> 

<resultMap type-"user" id="userResult"> 
<result column="id" property="id"/> 
<result column="name" property="name"/> 
<result column-"age" property="age"/> 
«result column-"money" property="money"/> 
«result column-"status" property-"status" 

typeHandler-"org.apache.ibatis.type.EnumTypeHandler"/» 

</resultMap> 

<select id="getUser" parameterType="int" 
resultType-"User" resultMap="userResult"> 
select * from t_user where id=#{id} 

</select> 

</mapper> 


这 里 主要 了 解 枚 举 的 使 用 ， 涉 及 resultMap 的 一 些 知识 可 以 先 略 过 ， 后 面 会 对 select. 
resultMap 这 些 做 进一步 介绍 。 在 上 面 UserMapper.xml 中 使 用 typeHandler 来 指定 枚 举 类 型 ， 


由 于 typeHandler=org.apache.ibatis.type.EnumTypeHandler， 因 此 在 新 增 用 户 时 数据 库 保 存 的 是 
UserState 的 name。 如 果 想 保存 枚 举 的 索引 , 只 需 把 typeHandler 改 为 EnumOrdinalTypeHandler. 
在 下 面 的 mian 方法 中 ,首先 新 增 一 个 user 并 获取 到 对 应 的 自 增 id， 根据 id 再 查询 出 user， 打 
印 出 来 。 有 一 点 要 特别 注意 ， 别 忘记 执行 session.commit0， 和 否则 虽然 会 查询 到 用 户 自 增 id, 
但 数据 库 中 并 不 存在 数据 。 


public static void main( String[] args ) throws IOException 
{ 
String resource = "mybatis-config.xml"; 
// 使 用 MyBatis 提供 的 Resources RMR mybatis 的 配置 文件 ( 它 也 加 载 关联 的 映射 文件 ) 
Reader reader = Resources.getResourceAsReader (resource); 
// 构 建 sqlSession 的 工厂 
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder(). 
build (reader); 
// 创 建 能 执行 映射 文件 中 sql 的 sqlSession 
SqlSession session = sessionFactory.openSession(); 
String statement-"com.demo.mybatis.DBMapping.UserMapper.addUser"; 
User user-new User ("usermode", 22, 222.22,UserState.AVAILABLE) ; 
session. insert (statement, user) ; 
session.commit () 7 
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System. out.println(user.getId()); 
statement-"com.demo.mybatis.DBMapping.UserMapper.getUser"; 
user-session.selectOne (statement, user.getId()); 
System.out.println(user.toString()); 

H 


输出 结果 如 下 : 


46 
Id:46 Name:usermode Age:22 Money:222.22 Status:AVAILABLE 


2. 自 定义 处 理 器 


有 时 候 MyBatis 默认 的 类 型 转换 器 并 不 能 满足 需求 ， 我 们 也 可 以 自 定义 。MyBatis 提供 了 
org.apache.ibatis.type.BaseTypeHandler 类 ， 用 于 我 们 自己 扩展 类 型 转换 器 ， 上 面 的 
EnumTypeHandler 和 EnumOrdinalTypeHandler 也 都 实现 了 这 个 接口 。 这 里 自 定 义 了 
CusEnumStatusHandler 类 ， 实 现 了 BaseTypeHandler 接口 。 这 里 采用 EnumOrdinalTypeHandler 
模式 保存 数字 ， 在 用 的 时 候 直接 引用 。 


package com.demo.model; 

import java.sql.CallableStatement; 

import java.sql.PreparedStatement; 

import java.sql.ResultSet; 

import java.sql.SQLException; 

import org.apache.ibatis.type.BaseTypeHandler; 
import org.apache.ibatis.type.JdbcType; 


public class CusEnumStatusHandler extends BaseTypeHandler<UserState>{ 


GOverride 
public void setNonNullParameter(PreparedStatement ps, int i, UserState 
parameter, JdbcType jdbcType) 
throws SQLException ( 
ps.setInt(i, parameter.getStatus()); 


GOverride 
public UserState getNullableResult(ResultSet rs, String columnName) 
throws SQLException ( 
return UserState. fromValue(rs.getInt (columnName)); 


@Override 
public UserState getNullableResult (ResultSet rs, int columnIndex) throws 
SQLException { 


return UserState.fromValue(rs.getInt (columnIndex) ) ; 
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@Override 


public UserState getNullableResult (CallableStatement cs, int columnIndex) 
throws SQLException { 


return UserState. fromValue(cs.getInt (columnIndex) ) ; 


) 


在 上 面 的 代码 中 主要 调用 了 UserState 中 的 fromValue 方法 ， 下 面 是 fromValue 方法 的 
实现 。 


public static UserState fromValue(int value) 
{ 
for(UserState userState:UserState.values()) 
{ 
if (userState.status==value) 
{ 


return userState; 


} 


throw new IllegalArgumentException("Cannot create evalue from value: " 
+ value + "!"); 


} 


定义 好 之 后 只 需 将 UserMapper.xml 中 resultMap 节点 中 的 typeHandler 设置 为 自 定义 类 型 
转换 器 类 即 可 。 此 时 再 执行 main 方法 中 的 新 增 查 询 ， 一 样 可 以 查 出 结果 。 
<resultMap type-"user" id="userResult"> 
<result column="id" property="id"/> 
<result column="name" property="name"/> 
<result column="age" property="age"/> 
<result column="money" property="money"/> 
«result column-"status" property-"status" 
typeHandler-"com.demo.model.CusEnumStatusHandler"/» 
</resultMap> 


6.2.5 配置 环境 (environments) 


在 项 目 开发 过 程 中 往往 有 几 套 环境 ， 例 如 开发 、 测 试 和 生产 环境 ， 而 每 个 环境 可 能 会 有 不 
同 的 配置 ， 或 者 共享 相同 Schema 的 多 个 生产 数据 库 。MyBatis 可 以 配置 成 适应 多 种 环境 ， 这 
种 机 制 有 助 于 将 SQL 映射 应 用 于 多 种 数据 库 之 中 。 不 过 尽管 可 以 配置 多 个 环境 ， 每 个 
SqlSessionFactory 实例 只 能 选择 其 一 。 如 果 想 连接 两 个 数据 库 ， 就 需要 创建 两 个 
SqlSessionFactory 实例 ， 每 个 数据 库 对 应 一 个 。 
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为 了 指定 创建 哪 种 环境 ， 只 要 将 它 作 为 可 选 的 参数 传递 给 SqlSessionFactoryBuilder 即 可 ， 
其 中 environment, properties 两 个 参数 是 可 选 ， 如 果 忽略 了 环境 参数 ， 那 么 默认 环境 将 会 被 
加 载 。 


SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, 
environment, properties); 


环境 元 素 如 何 配置 呢 ? 它 又 包含 哪些 属性 信息 呢 ? 下 面 是 6.1.3 节 配置 的 环境 。 


<environments default="development"> 
<environment id="development"> 
<transactionManager type="JDBC" /> 
<!-- 配置 数据 库 连接 信息 --> 
<dataSource type="POOLED"> 
<property name-"driver" value="${driver}" /> 
<property name-"url" value="${url}" /> 
<property name="username" value="${username}" /> 
<property name="password" value="${password}" /> 
</dataSource> 
</environment> 
</environments> 


MyBatis 支持 多 环境 配置 ， 所 以 environments 元 素 可 以 配置 多 个 environment 子 元 素 ， 每 
一 个 子 元 素 使 用 id 属性 区 分 ， 在 environments 中 通过 default 属性 指定 默认 环境 配置 。 在 每 个 
子 元 素 environment 中 又 包含 两 个 子 元 素 : 事务 管理 器 (transactionManager) 和 数据 源 


(dataSource) 。 

1. 事务 管理 器 (transactionManager) 

在 MyBatis 中 有 两 种 类 型 的 事务 管理 器 (也 就 是 type="[JDBCIMANAGED]") : 

。 JDBC: 这 个 配置 就 是 直接 使 用 了 JDBC 的 提交 和 回 滚 设置 ， 它 依赖 于 从 数据 源 得 到 的 连 
接 来 管理 事务 作用 域 。 上 面 的 配置 就 是 使 用 的 JDBC 类 型 。 

* MANAGED: 这 个 配置 几乎 没 做 什么 。 它 从 来 不 提交 或 回 滚 一 个 连接 ， 而 是 让 容器 来 管 
理事 务 的 整个 生命 周期 (比如 JEE 应 用 服务 器 的 上 下 文 ) 。 默 认 情况 下 ， 它 会 关闭 连接 ， 
然而 一 些 容器 并 不 希望 这 样 ， 因 此 需要 将 closeConnection 属性 设置 为 false 来 阻止 它 默 
认 的 关闭 行为 。 例 如 : 
<transactionManager type="MANAGED"> 

<property name-"closeConnection" value="false"/> 
</transactionManager> 

如 果 使 用 Spring + MyBatis， 就 没有 必要 配置 事务 管理 器 ， 因 为 Spring 模块 会 使 用 自 带 的 

器 来 覆盖 前 面 的 配置 。 


2. 数据 源 (dataSource) 
dataSource 元 素 使 用 标准 的 JDBC 数据 源 接口 来 配置 JDBC 连接 对 象 的 资源 。 有 三 种 内 建 


b 
E 
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的 数据 源 类 型 (也 就 是 type="[UNPOOLEDIPOOLEDIJNDI]" )。 上 面 例子 设置 的 type=POOLED. 
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UNPOOLED: 这 个 数据 源 的 实现 只 是 每 次 被 请 求 时 打开 和 关闭 连接 。 虽 然 有 点 慢 ， 但 对 
于 在 数据 库 连 接 可 用 性 方面 没有 太 高 要 求 的 简单 应 用 程序 来 说 ,是 一 个 很 好 的 选择 。 不 同 
的 数据 库 在 性 能 方面 的 表现 也 是 不 一 样 的 ， 对 于 某 些 数据 库 来 说 ， 使 用 连接 池 并 不 重要 ， 
这 个 配置 就 很 适合 这 种 情形 。UNPOOLED 类 型 的 数据 源 仅仅 需要 配置 以 下 5 种 属性 : 


> driver: 这 是 JDBC 驱动 的 Java 类 的 完全 限定 名 (并 不 是 JDBC 驱动 中 可 能 包含 的 数 
据 源 类 ) 。 

url: 这 是 数据 库 的 JDBC URL 地 址 。 

username: 登录 数据 库 的 用 户 名 。 

password: 登录 数据 库 的 密码 。 

defaultTransactionIsolationLevel: 默认 的 连接 事务 隔离 级 别 。 


POOLED: 这 种 数据 源 的 实现 利用 “ 池 ” 的 概念 将 JDBC 连接 对 象 组 织 起 来 ， 吉 免 了 创 
建新 的 连接 实例 时 所 必需 的 初始 化 和 认证 时 间 。 这 是 一 种 使 得 并 发 Web 应 用 快速 响应 
请 求 的 流行 处 理 方式 。 

除了 上 述 提 到 UNPOOLED 下 的 属性 外 ， 还 有 更 多 属性 用 来 配置 POOLED 的 数据 源 : 


vyv v 


> poolMaximumActiveConnections: 在 任意 时 间 可 以 存在 的 活动 (也 就 是 正在 使 用 ) 连 
接 数量 ， 默 认 值 为 10。 

> poolMaximumldleConnections: 任意 时 间 可 能 存在 的 空闲 连接 数 。 

> poolMaximumCheckoutTime: 在 被 强制 返回 之 前 ， 池 中 连接 被 检 出 (checked out) 时 
间 ， 默 认 值 为 20000 BAY (20 秒 ) 。 

> poolTimeToWait: 这 是 一 个 底层 设置 ， 如 果 获 取 连 接 花 费 了 相当 长 的 时 间 ， 连 接 池 会 
打印 状态 日 志 并 重新 尝试 获取 一 个 连接 (避免 在 误 配 置 的 情况 下 一 直 安 静 地 失败 ) ， 
默认 值 为 20000 毫秒 (20 秒 ) 。 

> poolMaximumLocalBadConnectionTolerance: 这 是 一 个 关于 坏 连接 容忍 度 的 底层 设置 ， 
作用 于 每 一 个 尝试 从 缓存 池 获 取 连 接 的 线程 。 如 果 这 个 线程 获取 到 的 是 一 个 坏 的 连 
接 ， 数 据 源 就 会 允许 这 个 线程 尝试 重新 获取 一 个 新 的 连接 ， 但 是 这 个 重新 尝试 的 次 数 
不 应 该 超过 poolMaximumIdleConnections 5 poolMaximumLocalBadConnection- 
Tolerance 之 和 。 默 认 值 为 3 (新 增 于 3.4.5) © 

> poolPingQuery: 发 送 到 数据 库 的 侦 测 查询 ， 用 来 检验 连接 是 否 正常 工作 并 准备 接受 请 
Ro RIŽ “NO PING QUERY SET”， 这 会 导致 多 数 数 据 库 驱 动 失败 时 带 有 一 个 恰 
当 的 错误 消息 。 

> poolPingEnabled: 是 否 启用 侦 测 查询 。 若 开启 ， 需 要 设置 poolPingQuery 属性 为 一 个 
可 执行 的 SQL 语句 〈 最 好 是 一 个 速度 非常 快 的 SQL 语句 ) ， 默 认 值 为 false。 

> poolPingConnectionsNotUsedFor: 配置 poolPingQuery 的 频率 。 可 以 被 设置 为 和 数据 库 
连接 超时 时 间 一 样 来 避免 不 必要 的 侦 测 ， 默 认 值 为 0 (所 有 连接 每 一 时 刻 都 被 侦 测 ， 
当然 仅 当 poolPingEnabled 为 true 时 适用 ) 。 
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。 INDI: 这 个 数据 源 的 实现 是 为 了 能 在 EJB 或 应 用 服务 器 这 类 容器 中 使 用 ， 容 器 可 以 集中 或 
在 外 部 配置 数据 源 ， 然 后 放置 一 个 JNDI 上 下 文 的 引用 。 这 种 数据 源 配置 只 需要 两 个 属性 : 
> initial context: 这 个 属性 用 来 在 InitialContext 中 寻找 上 下 文 〈 即 initialContext.lookup 
(initial_context)) 。 这 是 一 个 可 选 属性 ， 如 果 忽略 ， 那 么 data_source 属性 将 会 直接 从 
InitialContext 中 寻找 。 

> data source: 这 是 引用 数据 源 实 例 位 置 的 上 下 文 的 路 径 。 提 供 了 initial context 配置 时 
会 在 其 返回 的 上 下 文中 进行 查找 ， 没 有 提供 时 则 直接 在 InitialContext 中 查找 。 


6.2.6 映射 器 (mappers) 


在 UserMapper.xml 文件 配置 中 还 有 一 个 元 素 未 介绍 ， 那 就 是 mappers 元 素 ， 实 体 类 与 数 
据 库 表 的 纽带 就 是 通过 该 元 素 。mappers 元 素 包含 若干 mapper 子 元 素 ， 子 元 素 告诉 MyBatis 
到 哪里 去 找 映 射 文件 。 这 里 可 以 使 用 相对 于 类 路 径 的 资源 引用 , 或 完全 限定 资源 定位 符 (包括 
file:/// 的 URL) ， 或 类 名 和 包 名 等 。 在 UserMapper.xml 中 使 用 的 是 相对 于 类 路 径 的 资源 引用 。 
<mappers> 


<mapper resource-"com/demo/mybatis/DBMapping/UserMapper.xml" /> 
</mappers> 


mapper 元 素 也 可 以 通过 url 属性 指定 一 个 Mapper.xml 文件 。 


<mappers> 
<mapper url-"file:///C:/Users/admin/Desktop/UserMapper.xml"/» 
</mappers> 
使 用 mappers 映射 器 配置 会 告诉 MyBatis 去 哪里 找 映 射 文件 ， 剩 下 的 细节 就 应 该 是 每 个 
SQL 映射 文件 了 。 


6.3 XML 映射 文件 


映射 是 ORM 中 最 主要 的 部 分 ，MyBatis 的 真正 强大 在 于 它 的 映射 语句 ， 也 是 它 的 魔力 所 
在 。 由 于 它 异常 强大 , 映射 器 的 XML 文件 就 显得 相对 简单 。 如 果 拿 它 跟 具有 相同 功能 的 JDBC 
代码 进行 对 比 ， 你 会 立即 发 现 省 掉 了 将 近 95% 的 代码 。MyBatis 就 是 针对 SQL 构建 的 ， 并 且 
比 普通 的 方法 做 的 更 好 。SQL 操作 大 部 分 都 是 增 、 删 、 改 、 查 ， 所 以 可 以 参照 SQL 操作 来 了 
解 MyBatis 对 应 的 实现 。SQL 映射 文件 有 很 少 的 几 个 顶级 元 素 : cache、cache-ref、resultMap、 
sql. insert, update, delete. select. 


6.3.1 查询 元 素 select 


在 上 面 UserMapper.xml 中 ， 有 两 个 地 方 使 用 到 了 select 元 素 ， 一 个 是 查询 Tt user 表 中 所 
有 user， 另 一 个 是 根据 id 查询 user. 
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<select id="getUserList" resultType="User" > 
select * from t_user 

</select> 

<select id="getUser" parameterType-"int" 
resultMap="userResult"> 
select * from t_user where id=#{id} 

</select> 


select 元 素 中 除了 配置 id. paramterType 等 属性 ， 还 可 以 配置 其 他 属性 。 表 6-3 是 select 
可 配置 的 属性 列表 。 


表 6-3 select 可 配置 的 属性 列表 


属 性 描 述 

id 在 命名 空间 中 唯一 的 标识 符 ， 可 以 被 用 来 引用 这 条 语句 

将 要 传 入 这 条 语句 的 参数 类 的 完全 限定 名 或 别名 。 这 个 属性 是 可 选 的 ， 因 为 MyBatis 可 以 通 
过 TypeHandler 推断 出 具体 传 入 语句 的 参数 ， 默 认 值 为 unset 

从 这 条 语句 中 返回 的 期 望 类 型 的 类 的 完全 限定 名 或 别名 。 注 意 ， 如 果 是 集合 情形 ， 那 应 该 是 
集合 可 以 包含 的 类 型 ， 而 不 能 是 集合 本 身 。 使 用 resultType 或 resultMap， 但 不 能 同时 使 用 
外 部 resultMap 的 命名 引用 。 结 果 集 的 映射 是 MyBatis 最 强大 的 特性 ， 对 其 能 够 很 好 地 理解 的 
话 ， 许 多 复杂 映射 的 情形 都 能 迎刃而解 。 使 用 resultMap 或 resultType， 但 不 能 同时 使 用 
将 其 设置 为 tue, 任何 时 候 只 要 语句 被 调用 ,都 会 导致 本 地 缓存 和 二 级 缓存 被 清空 , 默认 值 为 
false 

useCache 将 其 设置 为 tue， 将 会 导致 本 条 语句 的 结果 被 二 级 缓存 。 默 认 值 是 对 select 元 素 为 true 

这 个 设置 是 在 抛 出 异常 之 前 ， 驱 动 程序 等 待 数据 库 返 回 请 求 结果 的 秒 数 。 默 认 值 为 unset〔 依 
赖 驱动 ) 

这 是 尝试 影响 驱动 程序 每 次 批量 返回 的 结果 行 数 和 这 个 设置 值 相等 。 默 认 值 为 unset (依赖 驱 
动 ) 

STATEMENT，PREPARED 或 CALLABLE 的 一 个 。 这 会 让 MyBatis 分 别 使 用 Statement、 
PreparedStatement 或 CallableStatement， 默 认 值 为 PREPARED 

FORWARD ONLY, SCROLL SENSITIVE 或 SCROLL INSENSITIVE 中 的 一 个 ， 默 认 值 为 
unset 〈 依 赖 驱动 ) 

如 果 配 置 了 databaseldProvider, MyBatis 会 加 载 所 有 不 带 databaseld 或 匹配 当前 databaseld 的 
语句 ， 如 果 带 或 者 不 带 的 语句 都 有 ， 则 不 带 的 会 被 名 略 

这 个 设置 仅 针 对 嵌 套 结果 select 语句 适用 : 如 果 为 tue， 就 是 假设 包含 了 霸 套 结果 集 或 是 分 
resultOrdered ”| 组 了 ， 这 样 的 话 当 返 回 一 个 主 结果 行 的 时 候 就 不 会 发 生 对 前 面 结果 集 的 引用 情况 。 这 就 使 得 
在 获取 嵌 套 的 结果 集 的 时 候 不 至 于 导致 内 存 不 够 用 。 默 认 值 为 false 

这 个 设置 仅 对 多 结果 集 的 情况 适用 ， 它 将 列 出 语句 执行 后 返回 的 结果 集 并 为 每 个 结果 集 给 一 
个 名 称 ， 名 称 是 逗号 分 隔 的 


parameterType 


resultType 


resultMap 


flushCache 


timeout 


fetchSize 


statementType 


resultSetType 


databaseld 


resultSets 
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6.3.2 ”更 新 元 素 Insert, Update, Delete 


Insert, Update. Delete 三 个 元 素 都 是 更 新 操作 ， 实 现 也 比较 相似 。 表 6-4 所 示 是 三 个 元 素 


对 应 的 属性 。 


#264 Insert, Update, Delete 三 个 元 素 对 应 的 属性 
H £ 


在 命名 空间 中 唯一 的 标识 符 ， 可 以 被 用 来 引用 这 条 语句 


parameterType 


将 要 传 入 这 条 语句 的 参数 类 的 完全 限定 名 或 别名 。 这 个 属性 是 可 选 的 ， 因 为 MyBatis 可 以 
通过 TypeHandler 推断 出 具体 传 入 语句 的 参数 ， 默 认 值 为 unset 


flushCache 


timeout 


将 其 设置 为 tue， 任 何 时 候 只 要 语句 被 调用 ， 都 会 导致 本 地 缓 在 和 二 级 缓存 被 清空 ， 默 认 
1&3 false 

这 个 设置 是 在 抛 出 异常 之 前 ， 驱 动 程序 等 待 数据 库 返回 请 求 结果 的 秒 数 ， 默 认 值 为 unset 
(依赖 驱动 ) 


statementType 


STATEMENT, PREPARED 或 CALLABLE 的 一 个 。 这 会 让 MyBatis 分 别 使 用 Statement、 
PreparedStatement 或 CallableStatement， 默 认 值 为 PREPARED 


useGeneratedK eys 


keyProperty 


keyColumn 


databaseld 


仅 对 insert Fil update 有 用 , 这 会 令 MyBatis 使 用 JDBC 的 getGeneratedKeys 方法 来 取出 由 数 
据 库 内 部 生成 的 主键 (比如: 像 MySQL 和 SQL Server 这 样 的 关系 数据 库 管理 系统 的 自动 
递增 字段 ) ， 默 认 值 为 false 

仅 对 insert 和 update 有 用 ， 唯 一 标记 一 个 属性 ，MyBatis 会 通过 getGeneratedKeys 的 返回 值 
或 者 通过 insert 语句 的 selectKey 子 元 素 设置 它 的 键 值 ， 默认 为 unset。 如 果 希 望 得 到 多 个 生 
成 的 列 ， 也 可 以 是 逗号 分 隔 的 属性 名 称 列表 

仅 对 insert 和 update 有 用 , 通过 生成 的 键 值 设置 表 中 的 列 名 , 这 个 设置 仅 在 某 些 数据 库 ( 像 
PostgreSQL) 是 必需 的 ， 当 主键 列 不 是 表 中 的 第 一 列 的 时 候 需 要 设置 。 如 果 和 希望 得 到 多 个 
生成 的 列 ， 也 可 以 是 逗号 分 隔 的 属性 名 称 列表 

如 果 配 置 了 databaseldProvider, MyBatis 会 加 载 所 有 不 带 databaseld 或 匹配 当前 databaseld 
的 语句 ， 如 果 带 或 者 不 带 的 语句 都 有 ， 则 不 带 的 会 被 忽略 


在 UserMapper.xml 中 ， 我 们 使 用 了 insert 元 素来 插入 数据 ， 同 时 获取 自 增 主键 id 值 。 


«insert id-"addUser" parameterType="user"> 
<selectKey resultType-"java.lang.Integer" order-"AFTER" 
keyProperty="id"> 
SELECT LAST_INSERT_ID() 
</selectKey> 
insert into t_user(name,age,money,status) values (#{name},#{age}, 


# {money}, f (status, typeHandler=com.demo.model .CusValuedEnumTypeHandler}) 


</insert> 


EHEH selectKey 元 素来 获取 插入 数据 时 的 自 增 主键 。 表 6-5 所 示 是 selectKey 元 素 的 主 


要 属性 。 
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表 6-5 selectKey 元 素 的 主要 属性 


Ho 述 

在 命名 空间 中 唯一 的 标识 符 ， 可 以 被 用 来 引用 这 条 语句 

将 要 传 入 这 条 语句 的 参数 类 的 完全 限定 名 或 别名 。 这 个 属性 是 可 选 的 ， 因 为 MyBatis 可 以 通 
过 TypeHandler 推断 出 具体 传 入 语句 的 参数 ， 默 认 值 为 unset 

从 这 条 语句 中 返回 的 期 望 类 型 的 类 的 完全 限定 名 或 别名 。 注 意 ， 如 果 是 集合 情形 ， 那 应 该 是 
集合 可 以 包含 的 类 型 ， 而 不 能 是 集合 本 身 。 使 用 resultType 或 resultMap， 但 不 能 同时 使 用 
外 部 resultMap 的 命名 引用 。 结 果 集 的 映射 是 MyBatis 最 强大 的 特性 ， 对 其 能 够 很 好 地 理解 的 
话 ， 许 多 复杂 映射 的 情形 都 能 迎刃而解 。 使 用 resultMap 或 resultType， 但 不 能 同时 使 用 
将 其 设置 为 mwe， 任 何 时 候 只 要 语句 被 调用 ， 都 会 导致 本 地 缓存 和 二 级 缓存 被 清空 ， 默认 值 
为 false 

将 其 设置 为 ue， 将 会 导致 本 条 语句 的 结果 被 二 级 缓 在， 默认 值 是 对 select 元 素 为 true 


6.3.3 可 重用 语句 块 sql 


sql 元 素 可 以 被 用 来 定义 可 重用 的 SQL 代码 段 ， 可 以 包含 在 其 他 语句 中 。 它 可 以 被 静态 地 

〈 在 加 载 参数 时 ) 参数 化 。 不 同 的 属性 值 通过 包含 的 实例 变化 。 有 时 SQL 中 有 一 些 是 重复 的 语 

句 块 ， 可 以 使 用 sql 元 素来 实现 SQL 语句 块 的 复 用 。 这 里 以 下 面 的 select 查询 语句 为 例子 来 了 解 
sql 元 素 的 使 用 。 该 SQL 语句 查询 别名 为 tl 的 tuser 表 中 的 id. name, age, money, status 字段 。 


select tl.id,tl.name,tl.age,tl.money,tl.status from t user as tl 


下 面 的 xml 配置 将 查询 字段 、 表 名 、from 部 分 分 别 作为 一 个 sql Fr Bt. sql 片段 可 以 通过 
include 被 包含 在 其 他 语句 中 (其 他 语句 也 包含 sql 片段 )， 属 性 值 也 可 以 被 用 在 include 元 素 
的 refid 属性 里 或 include 内 部 语句 中 。userColumns、sometable 都 是 将 属性 值 放 在 include 内 部 
语句 中 ，someinclude 将 属性 值 放 在 了 refid 属性 中 。 

<sql id="userColumns"> 
${alias}.id,${alias}.name,${alias}.age,${alias}.money,${alias}.status 

</sql> 

<sql id="sometable"> 


parameterType 


resultType 


resultMap 


flushCache 


${prefix}user as ${alias} 
</sql> 
<sql id="someinclude"> 


from 
<include refid="${include_target}"/> 
</sql> 
<select id="getUserList2" resultMap="userResult"> 
select 
<include refid="userColumns"><property name-"alias" value="t1"/> 
</include> 


<include refid="someinclude"> 
<property name-"prefix" value="t_"/> 
<property name-"alias" value="t1"/> 
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<property name="include_target" value="sometable"/> 
</include> 
</select> 
这 里 为 了 演示 sql 元 素 的 使 用 ， 把 一 条 简单 的 select 查询 语句 拆 得 比较 零散 ， 在 实际 项 目 
中 可 能 没 必要 拆 得 那么 复杂 。 不 过 适当 的 拆 分 还 是 有 必要 的 ， 这 样 也 能 复 用 一 些 sql 片段 。 


6.3.4 ”数据 集 映射 resultMap 


细心 的 话 可 能 会 从 前 面 章节 中 发 现 select 查询 用 户 标 签 有 两 种 写法 :一 个 是 使 用 resultType 
来 设置 返回 类 型 ， 一 个 是 使 用 resultMap 来 设置 返回 类 型 。 


<select id="getUserList" resultType="User"> 
select * from t user 


</select> 

<select id="getUserList" resultMap="userResult"> 
select * from t user 

</select> 


这 两 种 写法 都 是 正确 的 ， 那 么 resultType 和 resultMap 有 什么 关系 呢 ? 在 MyBatis 进行 查 
询 映射 的 时 候 ， 其 实 查询 出 来 的 每 一 个 属性 都 是 放 在 一 个 对 应 的 Map 里 面 的 ， 其 中 键 是 属性 
名 、 值 是 对 应 的 值 。 当 提供 的 返回 类 型 属性 是 resultType 的 时 候 ，MyBatis 会 将 Map 里 面 的 键 
值 对 取出 赋 给 resultType 所 指定 的 对 象 对 应 的 属性 。 所 以 其 实 MyBatis 的 每 一 个 查询 映射 的 返 
回 类 型 都 是 ResultMap， 只 是 当 我 们 提供 的 返回 类 型 属性 是 resultType 的 时 候 ，MyBatis 会 自 
动 地 给 我 们 把 对 应 的 值 赋 给 resultType 指定 对 象 的 属性 , 而 当 我 们 提供 的 返回 类 型 是 resultMap 
的 时 候 ， 因 为 Map 不 能 很 好 地 表示 领域 模型 ， 我 们 就 需要 自己 再 进一步 地 把 它 转化 为 对 应 的 
对 象 ， 这 常常 在 复杂 查询 中 很 有 作用 。 下 面 是 resultMap 元 素 的 概念 视图 。 


resultMap 


© constructor: 用 于 在 实例 化 类 时 注入 结果 到 构造 方法 中 。 

> idArg: ID 参数 ， 标 记 出 作为 ID 的 结 | ON 

> arg: 将 被 注入 到 构造 方法 的 一 个 普通 结 
e id: 一 个 ID 结果 ， 标 记 出 作为 ID 的 结 SED IA. 
* result: 注入 到 字段 或 JavaBean 属性 的 普通 结 
e association: 一 个 复杂 类 型 的 关联 ， 许 多 结 uar 

> KARRA: 关联 可 以 指定 为 一 个 resultMap 元 素 ， 或 者 引用 一 个 。 
* collection: 一 个 复杂 类 型 的 集合 

> KERRI: 集合 可 以 指 定 为 一 个 resultMap 元 素 ， 或 者 引用 一 个 。 
*  discriminator: 使 用 结果 值 来 决定 使 用 哪个 resultMap。 

> case: 基于 某 些 值 的 结果 映射 。 

。 RBA RR: 一 个 case 也 是 一 个 映射 它 本 身 的 结果 ， 因 此 可 以 包含 很 多 相同 的 
元 素 ， 或 者 参照 一 个 外 部 的 resultMap。 
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通常 一 个 复杂 数据 类 型 在 XML 中 的 配置 格式 如 下 : 


<!--column 不 做 限制 ， 可 以 为 任意 表 的 字段 ， 而 property 须 为 type 定义 的 pojo 属性 --> 
«resultMap id-"/É—//friN" type=" HÄÄ] pojo 于 并"> 
«id column- REEF, LAW UARA IPE FE" jdoclype="FRKA" 
property- "4 pojo XI EU EEEBIEE" /> 
«result column="KAI-?T FE (OHILUSIERGEBI — f FED " jdbcType=" FRW" 
propert y="#Gf#] pojo X/ fj — f HIE (BIA type EXHI pojo XI SUPE) BEED) "/> 
«association property-"pojo /fÜ—fX/& Hf£" javaType="pojo XJ pojo X/ St» 
«id column-" ZU pojo X SUIVIE ITE EET EL" jdbcType- " FRÆ" property-"AX 
FE pojo Xt RAVE ENR LE" 1» 
«result column="FRRWFE" jdbcType="FABA" property="HKE pojo WK 
PUER 
</association> 
<!-- 集合 中 的 property 须 为 oftype 定义 的 pojo 对 象 的 属性 --> 
«collection property-"pojo HRAM" ofType=" EA PÁ] pojo KR"> 
«id column=" AP pojo XJ SUI MN II LES" jdbclype="F NBA" property=" 
YELP pojo RIERA" /> 
«result column-" ZJ/LUNÍEEGE BITE" jdbcType=" FRH" property-"4EZ df 
pojo X BE" /> 
</collection> 
</resultMap> 


表 与 表 之 间 的 数据 映射 主要 有 一 对 一 、 一 对 多 和 多 对 多 的 关系 。 这 里 也 主要 介绍 
association. collection 的 使 用 。 为 了 演示 ， 准 备 了 4 张 数据 表 card. course. role 和 user role 
以 及 3 张 表 对 应 的 model. t_user 与 card 是 一 对 一 关系 ，t_user 与 course 是 一 对 多 关系 ，t_user 
与 role 是 多 对 多 关系 。 为 了 保存 多 对 多 关系 ， 增 加 了 user_role 表 。 


card 表 : 


CREATE TABLE ‘card* ( 
^id? int(11) NOT NULL AUTO INCREMENT, 
^cardNo' varchar(20) NOT NULL, 
"city? varchar(45) NOT NULL, 
^address^ varchar(100) NOT NULL, 
^userid? int(11) NOT NULL, 
PRIMARY KEY ("^id") 
) ENGINE-InnoDB AUTO INCREMENT-2 DEFAULT CHARSET-utf8; 


card 类 : 


Public class Card { 


@Override 
public String toString() { 
return "Card [id=" + getId() +", cardNo=" + cardNo +", city=" + city 
+ ",address="+address+",userid="+useridt+"]"; 
} 
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private int id; 

private String cardNo; 

private String city; 

private String address; 

private int userid; 

public int getUserid() { 
return userid; 

H 

public void setUserid(int userid) ( 
this.userid - userid; 

} 

public String getAddress() { 
return address; 

} 

public void setAddress (String address) { 
this.address = address; 

} 

public int getId() { 
return id; 

H 

public void setId(int id) ( 
this.id - id; 

) 

public String getCardNo() ( 
return cardNo; 

) 

public void setCardNo(String cardNo) ( 
this.cardNo - cardNo; 

) 

public String getCity() ( 
return city; 

) 

public void setCity(String city) ( 
this.city - city; 


} 
course X: 


CREATE TABLE ‘course’ ( 
^id" int(11) NOT NULL AUTO INCREMENT, 
`name` varchar(45) NOT NULL, 
^userid' int(11) NOT NULL, 
PRIMARY KEY (`id`) 
) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET-utf8; 
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course 类 : 


Public class Course { 

@Override 

public String toString() { 
return "Course [id=" + getId() + ", name=" + name +",userid= 

"tuserid+"]"; 

} 

private int id; 

private String name; 

private int userid; 

public int getUserid() { 
return userid; 

li 

public void setUserid(int userid) ( 
this.userid - userid; 

) 

public int getId() { 
return id; 

} 

public void setId(int id) { 
this.id = id; 

} 

public String getName() { 
return name; 

} 

public void setName (String name) { 
this.name = name; 


} 
role #: 


CREATE TABLE `role` ( 
^id? int(11) NOT NULL AUTO INCREMENT, 
^name^ varchar(45) NOT NULL, 
^desp' varchar(45) NOT NULL, 
PRIMARY KEY ("^id") 
) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET=utf8; 


role 类 : 


public class Role { 
@Override 
public String toString() { 
// TODO Auto-generated method stub 


return "Role [id=" + getId() +", name=" + name +",desp="tdespt"]"; 
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} 

private int id; 

private String name; 

private String desp; 

private List<User> users; 

public int getId() { 
return id; 

} 

public void setId(int id) { 
this.id = id; 

} 

public String getName() { 
return name; 

$ 

public void setName (String name) { 
this.name = name; 

} 

public String getDesp() { 
return desp; 

} 

public void setDesp (String desp) { 
this.desp = desp; 

} 

public List<User> getUsers() { 
return users; 

u 

public void setUsers(List<User> users) { 
this.users = users; 


} 
user role X: 


CREATE TABLE ‘user role' ( 
‘userid’ int(11) NOT NULL, 
^roleid^ int(11) NOT NULL, 
PRIMARY KEY (^userid', roleid') 
) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


上 面 把 数据 表 的 关系 和 单个 实体 类 已 经 准备 好 , 下 面 就 需要 准备 实体 类 之 间 的 关系 , 所 以 
需要 在 user 类 中 增加 下 面 几 个 属性 来 表示 实体 类 之 间 的 关系 。 
private Card card; 


public Card getCard() { 
return card; 


) 
public void setCard(Card card) ( 
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this.card = card; 
H 
private List<Role> roles; 
private List<Course> courses; 


public List<Course> getCourses() { 
return courses; 

H 

public void setCourses(List«Course» courses) { 
this.courses = courses; 

H 

public List<Role> getRoles() { 
return roles; 

} 

public void setRoles (List<Role> roles) { 
this.roles = roles; 


) 
现在 数据 表 和 实体 类 都 已 准备 完成 。 下 面 就 是 将 一 个 复杂 查询 的 结果 映射 到 实体 类 上 。 


<select id="getuser" parameterType="int" 
resultMap="userResultTest"> 

select a.id as user_id,a.name as user_name,a.age as user_age,a.money as 
user_money,a.status as user_status,b.id as card_id,b.cardNo as 
card_cardNo,b.userid as card_userid,b.city as card_city,b.address as 
card_address,c.id as course_id,c.name as course_name,c.userid as 
course_userid,e.name as role name,e.desp as role desp from t user a left join 
card b on a.id-b.userid left join course c on a.id-c.userid left join user role 
d on a.id-d.userid left join role e on d.roleid-e.id where a.id=#{id} 

</select> 


为 了 使 用 演示 表 之 间 一 对 一 、 一 对 多 和 多 对 多 的 关系 ， 上 面 的 sql 通过 t_user 依次 左 连接 
card. course. user role 和 role 表 。 而 该 sql 对 应 的 xml 映射 如 下 : 


<resultMap type="User" id="userResultTest"> 
<result column-"user id" property="id"/> 
<result column="user_name" property="name"/> 
«result column-"user age" property="age"/> 
«result column-"user money" property-"money"/» 
«result column-"user status" property-"status" typeHandler- 
"com.demo.model.CusEnumStatusHandler"/» 
«association property-"card" javaType-"Card" columnPrefix="card_"> 
«result column-"id" property="id"/> 
«result column-"no" property="cardNo"/> 
«result column-"city" property="city"/> 
«result column-"address" property="address"/> 
«result column-"userid" property="userid"/> 
</association> 
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<collection property="courses" javaType="ArrayList" ofType="Course" 
columnPrefix="course_"> 
<result column="id" property="id"/> 
<result column="name" property="name"/> 
«result column-"userid" property="userid"/> 
</collection> 
<collection property-"roles" javaType="ArrayList" ofType-"Role" 
columnPrefix="role_"> 
<result column="id" property="id"/> 
<result column="name" property="name"/> 


<result column="desp" property="desp"/> 
<result column="userid" property="userid"/> 
</collection> 
</resultMap> 


在 resultMap 中 user 与 card 对 象 是 一 对 一 关系 ,使 用 association 关联 ,对 于 一 对 多 的 关系 
使 用 collection 关联 ， 对 于 多 对 多 的 关系 可 以 理解 为 两 个 一 对 多 的 关系 。 现 在 又 出 现 一 个 新 的 
问题 ， 在 映射 Card. Course 和 Role 的 时 候 把 映射 关系 都 放 在 id=userResult 的 resultMap 中 ， 
这 样 如 果 以 后 要 映射 Card、Course、Role 的 时 候 还 要 写 一 遍 ， 复 用 性 不 高 。 其 实 我 们 可 以 在 
association 和 collection 节点 增加 属性 resultMap。 


<resultMap type="Card" id="cardResult"> 
<result column="id" property="id"/> 
«result column-"no" property="cardNo"/> 
«result column-"city" property="city"/> 
«result column-"address" property-"address"/» 
«result column-"userid" property="userid"/> 
</resultMap> 


<resultMap type-"Course" id="courseResult"> 
<result column="id" property="id"/> 
<result column="name" property="name"/> 
<result column="userid" property="userid"/> 

</resultMap> 

<resultMap type-"Role" id="roleResult"> 
<result column="id" property="id"/> 
<result column="name" property="name"/> 
<result column-"desp" property="desp"/> 
<result column-"userid" property="userid"/> 

</resultMap> 

<resultMap type-"User" id="userResultTest1"> 
<result column="user_id" property="id"/> 
<result column="user_name" property="name"/> 
«result column-"user age" property="age"/> 

«result column-"user money" property-"money"/» 
«result column-"user status" property-"status" typeHandler- 
"com.demo.model.CusEnumStatusHandler"/» 
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«association property-"card" javaType- "Card" resultMap="cardResult" 
columnPrefix="card_"></association> 
<collection property-"courses" javaType="ArrayList" ofType-"Course" 
resultMap-"courseResult" columnPrefix="course_"></collection> 
<collection property-"roles" javaType="ArrayList" ofType-"Role" 
resultMap-"roleResult" columnPrefix="role_"></collection> 
</resultMap> 


这 里 先 实 现 了 单个 表 的 映射 关系 , 然后 在 association 和 collection 中 使 用 resultMap 引用 这 
些 单 个 表 的 resultMap， 提 高 了 复 用 性 。 

在 resultMap 元 素 中 还 有 一 个 重要 的 子 元 素 discriminator (鉴别 器 ) 。 有 时 一 个 单独 的 数 
据 库 查询 也 会 返回 很 多 不 同 〈 但 是 希望 有 些 关 联 ) 数据 类 型 的 结果 集 , 或 者 有 时 一 个 父 类 有 多 
个 子 类 ， 每 个 子 类 有 不 同 的 属性 ， 而 每 个 基 类 对 应 的 数据 库 表 是 同一 个 表 ， 只 是 部 分 字段 为 
null. 鉴别 器 元 素 就 是 被 设计 来 处 理 这 些 情 况 的 。 鉴别 器 非常 容易 理解 , 因为 它 的 表现 很 像 Java 
语言 中 的 switch 语句 。 


<resultMap type="user" id="userResultTest2"> 

<id column="user_id" property="id"/> 

<result column="user_name" property="name"/> 

«result column-"user status" property-"status" typeHandler= 
"com.demo.model.CusEnumStatusHandler"/» 

«association property-"card" javaType- "Card" resultMap="cardResult" 
columnPrefix-"card "»«/association» 

«collection property- "courses" javaType- "ArrayList" ofType-"Course" 
resultMap-"courseResult" columnPrefix="course_"></collection> 

«collection property-"roles" javaType-"ArrayList" ofType-"Role" 
resultMap-"roleResult" columnPrefix="role_"></collection> 

<discriminator javaType-"string" column-"user status" 

«case value="0" resultType="User"> 

«result column-"user age" property="age"/> 
</case> 
<case value="1" resultType="User"> 
<result column-"user money" property="money"/> 
</case> 
</discriminator> 
</resultMap> 


在 上 面 的 resultMap 中 ， 根 据 user status 判断 ， 若 为 1， 则 映射 age 属性 忽略 money 属性 ， 
若 为 1， 则 映射 money 属性 忽略 age 属性 ， 这 里 的 resultType 都 是 User， 如 果 是 多 个 子 类 的 情 
况 ， 可 以 设置 resultType 为 不 同 的 子 类 。 


6.3.5 缓存 和 自 定义 缓存 


MyBatis 包含 一 个 非常 强大 的 查询 缓存 特性 ， 可 以 非常 方便 地 配置 和 定制 。 本 节 来 学 习 一 
下 MyBatis 缓存 和 自 定义 缓存 。 
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1. 自 带 缓存 


MyBatis 默认 开启 了 一 级 缓存 ， 一 级 缓存 是 在 SqlSession 层面 进行 缓存 的 ， 即 同一 个 
SqlSession， 多 次 调用 同一 个 Mapper 和 同一 个 方法 的 同一 个 参数 ， 只 会 进行 一 次 数据 库 查 询 ， 
然后 把 数据 缓存 到 缓冲 中 ， 以 后 直接 从 缓存 中 取出 数据 ， 不 会 直接 去 查 数据 库 。 不 同 的 
SqlSession 对 象 ， 因 为 不 用 的 SqlSession 都 是 相互 隔离 的 ， 所 以 相同 的 Mapper、 参 数 和 方法 还 
是 会 再 次 发 送 SQL 到 数据 库 去 执行 返回 结果 。 

为 了 克服 这 个 问题 ， 需 要 开启 二 级 缓存 ， 在 SqlSessionFactory 层面 给 各 个 SqlSession 对 
象 共 享 。 默 认 二 级 缓存 是 不 开启 的 ， 需 要 手动 进行 配置 。 手 动 开启 二 级 缓存 比较 简单 ， 首 先 开 
启 缓存 总 开关 , 在 MyBatis 的 配置 文件 settings 元 素 设置 cacheEnabled 参数 为 True, 然后 只 需 
在 SQL 映射 文件 中 添加 一 行 : <cache/>。 如 果 这 样 配置 的 话 ， 很 多 其 他 的 配置 就 会 被 默认 进 
行 ， 例 如 : 


(1) 映射 文件 所 有 的 select 语句 会 被 缓存 。 

(2) 映射 文件 的 所 有 insert. update 和 delete 语句 会 刷新 缓存 。 

(GO 缓存 会 使 用 默认 的 Least Recently Used (LRU， 最 近 最 少 使 用 原则 ) 的 算法 来 回收 
缓存 空间 。 

(4) 根据 时 间 表 ， 比 如 No Flush Interval (CNFI， 没 有 刷新 间隔) ， 缓 存 不 会 以 任何 时 
间 顺 序 来 刷新 。 

(5) 缓存 会 存储 列表 集合 或 对 象 无 论 查询 方法 返回 什么 ) 的 1024 个 引用 。 

(6) 缓存 会 被 视 为 是 read/write 〈 可 读 / 可 写 ) 的 缓存 ， 意 味 着 对 象 检索 不 是 共享 的 ， 而 
且 可 以 很 安全 地 被 调用 者 修改 ， 不 干扰 其 他 调用 者 或 线程 所 做 的 潜在 修改 。 


上 面 是 使 用 的 默认 属性 设置 ， 当 然 也 可 以 手动 配置 一 些 属性 。 
<cache eviction="LRU" flushInterval="100000" size="1024" readOnly="true"/> 
各 个 属性 的 意义 如 下 : 


* eviction: 缓存 回收 策略 。 
> LRU: 最 少 使 用 原则 ， 移 除 最 长 时 间 不 使 用 的 对 象 。 
> FIFO: 先进 先 出 原则 ， 按 照 对 象 进入 缓存 顺序 进行 回收 。 
> SOFT: 软 引 用 ， 移 除 基于 垃圾 回收 器 状态 和 软 引 用 规则 的 对 象 。 
> WEAK: 弱 引 用 ， 更 积极 地 移 除 基于 垃圾 回收 器 状态 和 弱 引 用 规则 的 对 象 。 

©  flushInterval: 刷新 时 间 间 隔 ， 单 位 为 毫秒 ， 这 里 配置 的 是 100 秒 。 如 果 不 配置 ， 那 么 只 
有 在 进行 数据 库 修改 操作 时 才 会 被 动 刷新 缓存 区 。 

* size: 引用 额 数目 ， 代 表 缓 存 最 多 可 以 存储 的 对 象 个 数 。 

e readOnly: 是 否 只 读 ， 如 果 为 true， 则 所 有 相同 的 sql 语句 返回 的 是 同一 个 对 象 《 有 助 于 
提高 性 能 ， 但 并 发 操作 同一 条 数据 时 ， 可 能 不 安全 ) ; 如 果 设 置 为 false， 则 相同 的 sql 后 
面 访问 的 是 cache 的 clone 副本 。 


如 果 开 启 了 二 级 缓存 , 映射 文件 所 有 的 select 语句 就 会 被 缓存 而 且 映 射 文件 的 所 有 Insert、 
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Update 和 Delete 语句 会 刷新 缓存 ， 但 有 时 也 会 遇 到 不 需要 进行 缓存 操作 实时 性 较 高 的 select 
语句 ， 或 者 执行 msert、Update 和 Delete 语句 之 后 不 需要 刷新 缓存 的 。 针 对 这 些 情 况 ， 可 以 在 
Mapper 的 具体 方法 下 设置 对 二 级 缓存 的 访问 意愿 。 


如 果 一 条 语句 每 次 都 需要 最 新 的 数据 , 就 意味 着 每 次 都 需要 从 数据 库 中 查询 数据 , 可 以 把 
useCache 这 个 属性 设置 为 false， 例 如 : 


<select id="getUserList" resultType="User" useCache="false"> 
select * from t_user 
</select> 


二 级 缓存 默认 会 在 Insert、Update、Delete 操作 后 刷新 缓存 ， 可 以 使 用 flushCache 属性 设 
置 为 false， 手 动 配置 不 更 新 缓存 ， 例 如 : 


<insert id="addUser" parameterType="user" flushCache="false"> 


2. 自 定义 缓存 


缓存 的 介质 可 以 有 多 种 。MyBatis 提供 了 org.apache.ibatis.cache.Cache 接口 ， 用 来 自 定义 
缓存 。 这 里 新 建 一 个 CusCache 类 ， 实 现 Cache 接口 fE CusCache 类 中 定义 一 个 
ConcurrentHashMap<Object,Objec 人 > 类 型 的 cache 变量 来 保存 缓存 。 


package com.demo.model; 

import java.util.concurrent.ConcurrentHashMap; 

import java.util.concurrent.locks.ReadWriteLock; 

import java.util.concurrent.locks.ReentrantReadWriteLock; 
import org.apache.ibatis.cache.Cache; 


public class CusCache implements Cache { 


private ReadWriteLock lock = new ReentrantReadWriteLock (); 

private ConcurrentHashMap<Object,Object> cache = new ConcurrentHashMap 
<Object, Object>(); 

private String id; 


public CusCache() { 
System.out.println(" 初 始 化 -1! "); 
H 


// 必 须 有 该 构造 函数 
public CusCache (String id) { 
System.out.Println(" 初 始 化 -2! "); 
this.id = id; 
} 


// 获取 缓存 编号 


public String getId() { 
System. out.printin("###] ID: " + id); 
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return id; 


// 获 取 缓存 对 象 的 大 小 
public int getSize() { 
System.out.println(" 获 取 缓存 大 小 ! "); 
return 0; 
H 
// 保存 key 值 缓存 对 象 
public void putObject (Object key, Object value) { 
System. out.println (" 往 缓存 中 添加 元 素 : key=" + key+", value=" + value); 
cache.put (key, value) ; 


// 通 过 KEY 

public Object getObject (Object key) { 
System. out.println ("通过 key 获取 值 : " + key); 
System. out.printin ("OVER"); 
System.out.println ("= 
System. out.printin("{AW: 
System.out.println ("======= 


return cache.get (key); 


// 通过 key 删除 缓存 对 象 

public Object removeObject (Object key) { 
System. out.println ("MRAM S: " + key); 
return null; 


// 清空 缓存 

Public void clear() { 
System.out.println(" 清 除 缓存 ! "); 
cache.clear(); 


// 获取 缓存 的 读 写 锁 

public ReadWriteLock getReadWriteLock() { 
System. out.println(" 获 取 锁 对 象 ! ! ! "); 
return lock; 


) 


自 定义 缓存 之 后 可 以 进行 验证 。 在 main 方法 中 ， 实 例 化 了 两 个 SqlSession 对 象 ， 在 第 一 
个 SqlSession 中 对 同一 个 statement 执行 两 次 select 查询 再 commit， 第 二 个 SqlSession 中 对 同 
一 个 statement 执行 同样 的 查询 并 commit。 
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String resource = "mybatis-config.xml 


// 使 用 MyBatis 提供 的 Resources 类 加 载 mybatis 的 配置 文件 〈 它 也 加 载 关联 的 映射 


Reader reader = Resources.getResourceAsReader (resource); 
// 构 建 sqlSession 的 工厂 


SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder(). 


build(reader) ; 
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4 


F 


ssscssssss5se====OVER========================= 一 -= 
Id:i Name:#= 
GEERDNTR. key=-731237125:4770985981 : com.demo.mybatis .DBMapping.UserMapper. getuser:: 2147: 
User age,a.money as user money,a.status as user_status,b.id as card_id,b.cardNo as card car| 
role desp 

on d.roleid-e.id 


BSKEYERA. -731237125:4770985981:com.demo.mybatis .DBMapping.UserMapper.getuser: 
user age,a.money as user money,a.status as user status,b.id as card id,b.cardNo as card car| 


role desp 
on d.roleid-e.id 


OVER 


// 创 建 能 执行 映射 文件 中 sql 的 sqlSession 

SqlSession session = sessionFactory.openSession(); 
String statement="com.demo.mybatis.DBMapping.UserMapper.getuser"; 
User user=session.selectOne(statement, 1); 
user=session.selectOne(statement, 1); 

System. out.println(user.toString()); 
session.commit (); 

SqlSession sessionl = sessionFactory.openSession(); 
user=sessionl.selectOne(statement, 1); 

System. out.println(user.toString()); 
sessionl.commit (); 


上 面 的 代码 ， 日 志 部 分 截图 如 图 6-1 所 示 。 


ge:0 Money:377.77 Status:AVAILABLE 


b.city as card city,b.address as card address,c.id as course id,c.name as course na| 
from t user a left join card b on a.id=b.userid left join course c on a.idec.userid 


where a.id=? 


:development, value=[Id:1 Name:#=Age:@ Money:377.77 Status:AVAILABLE] 


2147483647 
b.city as card city,b.address as card address,c.id as course id,c.name as course na| 
from t user a left join card b on a.id-b.userid left join course c on a.idec.userid| 


where a.ide?:1:development 


6-1 


从 日 志 中 可 以 看 出 , 每 次 查询 数据 库 前 , MyBatis 都 会 先 在 缓存 中 查找 是 否 有 该 缓存 对 象 。 
只 有 当 调 用 了 commit0 方 法 ，MyBatis 才 会 往 缓存 中 写 入 数据 ， 数 据 记 录 的 键 为 “数字 编号 
+Mapper 名 + 方法 名 +SQL 语句 + 参数 ”格式 ， 值 为 返回 的 对 象 值 。 所 以 在 第 一 个 SqlSession 对 
RK commit()Z hil, HE key 相同 ， 但 通过 key 获取 cache 缓存 对 象 都 为 null，commit() 之 后 再 
通过 该 key 获取 缓存 时 值 是 存在 的 。 
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5.4. 动态 sQL 


MyBatis 还 有 一 个 方便 的 功能 就 是 动态 SQL， 可 以 根据 条 件 智能 生成 SQL 语句 。MyBatis 
通过 if. choose, when, otherwise. trim, where, set, foreach 等 标签 ， 可 组 合成 非常 灵活 的 
SQL 语句 ， 从 而 在 提高 SQL 语句 的 准确 性 的 同时 ， 也 大 大 提高 了 开发 人 员 的 效率 。 


6.4.1 itga 


有 些 页 面 提 供 多 条 件 查询 功能 , 输入 值 时 进行 模糊 查询 , 不 输入 值 时 不 做 过 滤 条 件 。 这 样 
的 话 就 需要 拼接 where， 一 般 在 sql 后 面 加 where 1=1， 可 以 不 为 where 和 and 揪心 。 


<select id-"finduserbylikenamel" parameterType="string" resultMap= 
"userResult"> 
select * from t_user where 1=1 
<if test-" parameter!-null and _parameter!=''"> 
and name like £( parameter) 
</if> 
</select> 
<select id="finduserbylikename2" parameterType="map" resultMap= 
"userResult"» 
<bind name-"pattern" value-"'$' + parameter.name + '$'" /> 
select * from t_user where 1=1 
<if test-" parameter.name!-null and _parameter.name!=''"> 
and name like #{pattern} 
</if> 
</select> 


上 面 用 了 两 种 传 参 数 的 方式 : 一 种 是 string， 另 一 种 是 map. H map 可 以 传 多 个 参数 。 还 
有 就 是 在 第 二 种 中 使 用 了 bind， 可 以 在 sql 中 增加 %%。 人 参数 中 可 以 不 带 ， 下 面 是 两 个 传 参 的 
使 用 。 


String statement-"com.demo.mybatis.DBMapping.UserMapper. 
finduserbylikenamel"; 

List<User> users-session.selectList(statement, "$J$"); 

System.out.println(users.size()); 

for(int i-0;i«users.size();i-**) 

t 

System.out.println(users.get(i).toString()); 

} 

Statement-"com.demo.mybatis.DBMapping.UserMapper. 
finduserbylikename2"; 

Map«String,Object» map=new HashMap<String, Object>(); 

map.put("name", "J"); 
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users=session.selectList (statement, map); 
System. out.println(users.size()); 
for(int i=0;i<users.size();i++) 
{ 

System. out.println(users.get (i) .toString()); 
H 


6.4.2 choose (when, otherwise) 语 句 


做 项 目 也 经 常会 遇 到 左边 一 个 下 拉 框 选择 搜索 类 型 ， 按 什么 类 型 搜索 ， 右 边 一 个 文本 框 ， 
输入 搜索 关键 字 ， 点 查询 搜索 。 如 果 遇 到 这 种 情况 ， 用 choose 再 合适 不 过 了 。 


<select id="findcard" parameterType-"map" resultMap="cardResult"> 
<bind name-"pattern" value-"'$' + parameter.value + '$'" /> 
select * from card where 1=1 
<choose> 
<when test-"type--'city'"» 
AND city like #{pattern} 
</when> 
<when test="type=='address'"> 
AND address like #{pattern} 
</when> 
<otherwise> 
AND city like #{pattern} or address like #{pattern} 
</otherwise> 
</choose> 
</select> 


这 里 根据 type 来 判断 过 滤 哪 些 字段 。 如 果 是 city， 就 使 用 关键 字 过 滤 city 字段 ， 如 果 是 
address， 就 使 用 关键 字 过 滤 address 字段 ， 如 果 是 其 他 ， 就 为 city 和 address 过 滤 的 并 集 。 


6.4.3 choose (when, otherwise) 语 名 


对 对 象 的 修改 操作 , 可 能 有 时 需要 根据 不 同 的 条 件 修 改 不 同 的 列 。 比 如 根据 id 修改 name， 
根据 id 修改 age， 每 个 都 写 一 个 sql， 这 样 也 太 不 灵活 了 ， 于 是 trim HIT. trim 标记 是 一 个 
格式 化 的 标记 ， 可 以 完成 set 或 者 where 标记 的 功能 。prefix: 在 trim 标签 内 为 sql 语句 加 上 前 
4, suffix: 在 trim 标签 内 为 sql 语句 加 上 后 级 , suffixOverrides: 指 定 去 除 多 余 的 后 缀 内 容 。 例 如: 

“suffixOverrides="," ”去除 trim 标签 内 sql 语句 多 余 的 后 级 ","，“prefixOverrides: ”指定 去 除 
多 余 的 前 缀 内容 。 


«update id-"updatecard" parameterType="map"> 
update card 
«trim prefix-"set" suffixOverrides=", "> 
«if test-" parameter.cardNo!-null and _parameter.cardNo!=''"> 
cardNo = #{cardNo}, 
</if> 
<if test-"  parameter.city!-null and _parameter.city!=''"> 
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city = #{city}, 
</if> 
</trim> 
<trim prefix="WHERE" prefixOverrides="and|or"> 
«if test-"  parameter.id!-null and _parameter.id!=''"> 
and id = #{id} 
</if> 
<if test-"  parameter.address!-null and parameter.address!-''"» 
and address = #{address} 
</if> 
</trim> 
</update> 


有 了 trim， 可 以 很 方便 地 写 出 where, set 子 句 ， 而 不 用 担心 set 子 句 的 逗号 、where $4) 
的 and 和 or。 


6.4.4 foreach 语句 


有 时 候 sql 需要 使 用 in 查询 ， 通 常 传 的 是 一 个 collection 集合 ， 那 该 怎么 样 拼接 呢 ? 当然 
是 foreach. foreach 元 素 主要 有 下 面 几 个 属性 : 


e Item: 表示 集合 中 每 一 个 元 素 进行 和 迭代 时 的 别名 。 

* Index: 指定 一 个 名 字 ， 用 于 表示 在 迭代 过 程 中 每 次 迭代 到 的 位 置 。 
© Open: 表示 该 语句 以 什么 开始 。 

© Separator: 表示 在 每 次 进行 近代 之 间 以 什么 符号 作为 分 隔 符 。 

© Close: 表示 以 什么 结束 。 


在 下 面 的 例子 中 ，select 查询 根据 id 查询 用 户 ，parameterType 为 map。 


<select id="findcardbyuserids" parameterType="map" resultMap= 
"userResult"» 
select * from t user where id in 
«foreach collection-"ids" index-"index" item-"item" open="(" 
separator="," close-")"» 
#{item} 
</foreach> 
</select> 


在 main 中 调用 时 需要 为 该 查询 语句 传递 一 个 map 参数 。 


String statement-"com.demo.mybatis.DBMapping.UserMapper. 
findcardbyuserids"; 

List ids = new ArrayList (); 

ids.add("1"); 

ids.add("2"); 

ids.add ("3"); 

Map<String, Object> map-new HashMap<String, Object>(); 

map.put("ids", ids); 
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List<User> users=session.selectList (statement,map); 
for(int i=0;i<users.size();i++) 
{ 

System. out.println(users.get (i) .toString()); 


5.5 逆向 工程 


MyBatis 的 一 个 主要 特点 就 是 需要 程序 员 自己 编写 sql， 如 果 表 太 多 的 话 ， 难 免 会 很 麻烦 ， 所 
以 MyBatis 官方 提供 了 一 个 逆向 工程 ， 可 以 针对 单 表 自 动 生成 MyBatis 执行 所 需要 的 代码 (包括 
mapper.xml、mapperjava) 。 一 般 在 开发 中 ， 常 用 的 逆向 工程 方式 是 通过 数据 库 的 表 生 成 代码 。 

要 使 用 generator 插件 自动 生成 相关 文件 ， 需 要 引入 mybatis-generator-core 这 个 包 ， 在 
<dependencys> 中 加 入 : 


<dependency> 
<groupId>org.mybatis.generator</groupId> 
<artifactId>mybatis-generator-core</artifactId> 
<version>1.3.2</version> 

</dependency> 


引入 依赖 之 后 需要 引入 插件 maven-compiler-plugin 和 mybatis-generator-maven-plugin, [Fi] 
时 设置 自动 生成 代码 配置 : 


<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler-plugin</artifactId> 
<configuration> 
<source>1.8</source> 
<target>1.8</target> 
</configuration> 
<version>3.3</version> 
</plugin> 
<plugin> 
<groupId>org.mybatis.generator</groupId> 
<artifactId>mybatis-generator-maven-plugin</artifactId> 
<version>1.3.2</version> 
<dependencies> 
<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>5.1.35</version> 
</dependency> 
</dependencies> 
<configuration> 
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<!-- 配 置 文件 的 路 径 --> 
<configurationFile>src/main/resources/generatorConfig.xml 
</configurationFile> 
<overwrite>true</overwrite> 
</configuration> 
</plugin> 


在 引入 插件 时 需要 设置 自动 生成 插件 的 配置 文件 ， 这 里 新 建 一 个 generatorConfig.xml X 
件 ， 在 文件 中 以 t_user 表 为 例 来 了 解 自动 生成 插件 的 使 用 。 


<?xml version="1.0" encoding-"UTF-8"?» 
<!DOCTYPE generatorConfiguration 
PUBLIC "-//mybatis.org//DTD Mybatis Generator Configuration 1.0//EN" 
“http: //mybatis.org/dtd/mybatis-generator-config 1 0.dtd"> 
<generatorConfiguration> 
<context id-"DB2Tables" targetRuntime="MyBatis3"> 
<commentGenerator> 
<property name-"suppressDate" value="true"/> 
<property name-"suppressAllComments" value="true"/> 
</commentGenerator> 
<!-- 数 据 库 驱 动 ， 数 据 库 地 址 及 表 名 ， 账 号 ， 密 码 --> 
<jdbcConnection driverClass="com.mysql.jdbc.Driver" 
connectionURL-"jdbc:mysql://127.0.0.1:3306/daodemodb" userId-"root" 
password="123456"> 
</jdbcConnection> 
<javaTypeResolver> 
<property name="forceBigDecimals" value="false"/> 
</javaTypeResolver> 
<!-- 生 成 Model 类 的 包 名 及 存放 位 置 --> 
<javaModelGenerator targetPackage="com.demo.model" 
targetProject-"src/main/java"» 
Xproperty name-"enableSubPackages" value-"true"/» 
Xproperty name-"trimStrings" value-"true"/» 
</javaModelGenerator> 
<!-- 生 成 映射 文件 的 包 名 及 存放 位 置 --> 
<sqlMapGenerator targetPackage="com.demo.mybatis.DBMapping" 
targetProject-"src/main/java"» 
<property name-"enableSubPackages" value-"true"/» 
</sqlMapGenerator> 
<!-- 生 成 Dao 类 的 包 名 及 存放 位 置 --> 
<javaClientGenerator type="XMLMAPPER" 
target Package="com.demo.model" targetProject-"src/main/java"» 
<property name="enableSubPackages" value="true"/> 
</javaClientGenerator> 
<!-- 生 成 对 应 表 及 类 名 ,domainobjectName 是 设置 实体 类 的 名 字 的 --> 
<table tableName-"t user" domainObjectName="TUser" 
enableCountByExample-"false" enableUpdateByExample-"false" 
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enableDeleteByExample-"false" enableSelectByExample-"false" 
selectByExampleQueryId-"false"»«/table» 
</context> 
</generatorConfiguration> 


在 上 面 的 xml 中 设置 了 生成 映射 文件 、DAO 28. Model 类 的 包 名 及 存放 位 置 ， 并 设置 要 
生成 的 对 应 的 表 名 类 名 ， 这 里 只 设置 了 t_user 来 作为 参考 。 至 此 ， 就 已 配置 完成 ， 只 需 右 击 ， 
选择 Run As 一 Maven build。 如 图 6-2 所 示 ， 在 Goals 中 输入 “mybatis-generator:generate”。 


fi) Edit Configuration x 


Edit configuration and launch. Q 


Name: [XMLMybatisDemc| 


[E] Main \ mi JRE ^ Refresh | &; Source | BRB Environment | L] Common 
Base directory: 5 


project locXmlMybatisDemo] 


Workspace... File System.. Variables... 


Goals: 


Profiles: | 


User settings: [D:\Maven\apache-maven-3.5.2\conf\settingsxml —— 


Workspace... File System... Variables.. 
Domine (Update Snapshots 
DlDebugOutput [Skip Tests DNon-recursive 
Resolve Workspace artifacts 
1 Threads 


Parameter Name Value Add... 


Revert Apply 


Close 


图 6-2 


单 击 Run 按钮 ， 如 果 成 功 ， 就 会 在 命令 行 窗口 输出 BUILD SUCCESS。 刷 新 项 目 ， 可 以 
看 到 新 增 的 文件 ， 如 图 6-3 所 示 。 


XmiMybatisDemo 


~ (9 src/main/java < 
© Hi comdemo.model a re 
T) cardjava 
T) Coursejava - e 4 eclarat © Console 3i x = 


D CusCachejava 
(3) CusEnumStatusHandlerjava —— «termirated» XMLMybetisDemo Maven Buld] CA Program FlesVava\jre1 8.0 162\bin\javaw.exe (20185108205 下 午 9:29:1 
D) Role java [INFO] Scanning for projects... 
3] Teer java 

> P TUcerMapperjava 
T Userjava 
H UserStatejava 


~ ing 
F TUserMapperaml 


3| UserMapperaml 
4B com.demo.mybatis.demo 
src/mein/resources 
国 databese.properties 
IK! generatorConfigxml 
I| gereretorCorfig2xml. 

|X) mybatis-configaml 


--- mybatis-generator-maven-pli 
could be found 


1.3.2:generate (default-cli) @ XmiMybatisDemo --- 
Logger (org.mybatis. generator internal, db.Databaseintrospect 


info. 


[INFO] rinishe 
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名 .6 分 页 插件 pagehelper 


在 编写 Web 后 台 代 码 时 ， 分 页 是 必 不 可 少 的 ， 当 然 最 通常 的 思路 是 在 SQL 中 使 用 分 页 关 
键 字 来 进行 分 页 。 在 实际 开发 中 ， 更 多 的 是 使 用 分 页 插件 来 减少 代码 元 杂 ， 使 编码 更 加 清晰 。 
pagehelper 是 MyBatis 提供 的 分 页 插件 , 目前 支持 Oracle, MySQL, MariaDB、SQLite、Hsqldb、 
PostgreSQL 六 种 数据 库 。 本 节 主 要 介绍 pagehelper 的 简单 使 用 。 


1. 引入 依赖 
把 pagehelper 所 需 用 到 的 jar 包 添 加 到 工程 中 ， 官 方 提供 的 代码 对 逆向 工程 支持 不 好 ， 这 
里 使 用 的 是 开源 的 pagehelper， 只 需 在 pom.xml 中 引入 pagehelper 依赖 。 
<dependency> 
<groupId>com.github.pagehelper</groupId> 
<artifactId>pagehelper</artifactId> 
<version>3.4.2</version> 


</dependency> 


2. 配置 插件 
引入 依赖 之 后 ， 还 需要 在 mybatis-config.xml 中 配置 pagehelper 插件 ， 从 名 字 也 能 知道 是 
什么 ， 相 当 于 配置 了 一 个 拦截 器 。 


<plugins> 
<!-- com.github.pagehelper W PageHelper 类 所 在 包 名 --> 
<plugin interceptor="com.github.pagehelper.PageHelper"> 
<!-- 方言 -=> 
<property name-"dialect" value-"mysql"/» 
<!-- 该 参数 默认 为 false --> 
<!-- HBA true 时 ， 使 用 RowBounds 分 页 会 进行 count 查询 --> 
<property name-"rowBoundsWithCount" value="true"/> 
</plugin> 
</plugins> 


3. 分 页 测试 
pagehelper 插件 使 用 非常 简单 ， 只 需 上 面 两 步 即 可 进行 分 页 操作 ， 这 里 以 查询 t user 表 为 
例 。 将 t_user 表 中 的 数据 以 每 页 5 行进 行 分 页 ， 并 打印 出 数据 总 数 、 总 页 数 、 最 后 一 页 行 数 以 
及 第 一 页 的 数据 。 
SqlSession session = sessionFactory.openSession(); 
String statement-"com.demo.mybatis.DBMapping.UserMapper.getUserList"; 
PageHelper.startPage(1, 5, true); 
List<User> users-session.selectList (statement); 
PageInfo<User> pageInfo = new PageInfo«User» (users); 
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System.out.println (" 数 据 总 数 : " + pageInfo.getTotal()); 
System. out.print1n ("数据 总 页 数 : " + pageInfo.getPages()); 
System. out.println ("最 后 一 页 : " + pageInfo.getLastPage()); 
for (User u: users) 
{ 

System. out.println(u.toString()); 
} 


输出 结果 如 下 : 
数据 总 数 :11 


:JdbcDaoSupportTest Age:26 Money:333.33 Status:AVAILABLE 


: 张 三 Age:24 Money:666.66 Status:AVAILABLE 

Age:25 Money:888.88 Status:AVAILABLE 
: 王 二 Age:26 Money:999.99 Status:AVAILABLE 
:小 明 Age:27 Money:555.55 Status:AVAILABLE 


6.7 小 结 


本 章 主要 介绍 MyBatis 的 相关 知识 。 通 过 本 章 的 学 习 ， 大 家 对 ORM 框架 有 了 进一步 的 了 
解 ， 学 习 了 MyBatis 的 配置 文件 、 映 射 文件 、 动 态 SQL 等 内 容 ， 可 以 掌握 ORM 的 编程 思想 ， 
还 有 助 于 其 他 ORM 框架 的 学 习 。 
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JavaEE 体系 结构 包括 4 层 ， 从 上 到 下 分 别 是 应 用 层 、Web 层 、 业 务 层 、 持 久 层 。Spring 是 业 
务 层 的 框架 。MyBatis 是 持久 层 的 框架 。 本 章 将 学 习 Web 层 的 框架 一 一 Spring MVC. 


本 章 主要 涉及 到 的 知识 点 有 : 

MVC 设计 模式 : 了 解 MVC 设计 模式 。 

Spring MVC 处 理 流程 : 了 解 Spring 的 处 理 流程 、HandlerMapping 的 使 用 。 
数据 传递 : View 和 Controller 之 间 的 数据 传递 。 

拦截 器 : 了 解 Spring MVC 拦截 器 的 使 用 。 


MVC 框架 


MVC 框架 是 Web 开发 的 常用 框架 ， 不 仅 Java 语言 有 MVC 框架 ，C#、Python 等 其 他 语 
言 也 有 类 似 的 MVC 框架 , 那 MVC 框架 是 什么 、 由 哪些 部 分 组 成 、 为 什么 会 有 MVC 框架 呢 ? 


7.1.1 MVC 模式 简介 


MVC (Model View Controller) 是 模型 (Model) 一 视图 (View) 一 控制 器 (Controller) 
的 缩写 ， 一 种 软件 设计 典范 , 用 一 种 业务 逻辑 、 数 据 、 界 面 显示 分 离 的 方法 组 织 代码 ， 将 业务 
逻辑 聚集 到 一 个 部 件 里 面 , 在 改进 和 个 性 化 定制 界面 及 用 户 交 互 的 同时 , 不 需要 重新 编写 业务 
3X8. MVC 开始 是 存在 于 桌面 程序 中 的 ，M 是 指 业务 模型 ，V 是 指 用 户 界面 ，C 则 是 控制 器 ， 
使 用 MVC 的 目的 是 将 M 和 V 的 实现 代码 分 离 , 从 而 使 同一 个 程序 可 以 使 用 不 同 的 表现 形式 ， 
比如 一 批 统计 数据 可 以 分 别 用 柱状 图 、 饼 图 来 表示 。 

MVC 模式 把 用 户 界面 交互 分 拆 到 不 同 的 三 种 角色 中 ， 使 应 用 程序 被 分 成 三 个 核心 部 件 : 
Model (模型 ) . View 〈 视 图) Controller (控制 器 ) 。 它 们 各 自 处 理 自 己 的 任务 : 


(1) 模型 : 模型 持 有 所 有 的 数据 、 状 态 和 程序 逻辑 ， 独 立 于 视图 和 控制 器 。 

(2) 视图 : 用 来 呈现 模型 。 视 图 通常 直接 从 模型 中 取得 它 需 要 显示 的 状态 与 数据 。 对 于 
相同 的 信息 ， 可 以 有 多 个 不 同 的 显示 形式 或 视图 。 

GO 控制 器 : 位 于 视图 和 模型 中 间 ， 负 责 接受 用 户 的 输入 ， 将 输入 进行 解析 并 反馈 给 模 
型 ， 通 常 一 个 视图 具有 一 个 控制 器 。 


Spring 快速 入 门 


HA! (Model) 、 视 图 (View) 、 控 制 器 (Controller) 三 者 的 关系 如 图 7-1 所 示 。 


j ^ut 
SPB i 
Lo 获取 数据 S 
Ea ` 通知 视图 E 
E 7-1 


视图 中 用 户 的 输入 被 控制 器 解析 后 , 控制 器 改变 状态 激活 模型 , 模型 根据 业务 逻辑 维护 数 
据 ， 并 通知 视图 数据 发 生变 化 ， 视 图 得 到 通知 后 从 模型 中 获取 数据 刷新 自己 。 


7.1.2 MVC 和 设计 模式 区 别 


大 家 往往 把 框架 模式 和 设计 模式 混淆 ， 认 为 MVC 是 一 种 设计 模式 。 实 际 上 它们 完全 是 不 
同 的 概念 。 MVC 是 一 种 使 用 MVC (Model View Controller, 模型 -视图 -控制 器 ) 设计 创建 Web 
应 用 程序 的 模式 。 它 是 框架 的 一 种 模式 ， 类 似 ORM， 同 时 该 模式 下 可 能 有 多 种 框架 。 本 章 介 
绍 的 Spring MVC 是 一 个 框架 ， 而 这 个 框架 的 模式 是 MVC 模式 。 设 计 模 式 是 对 在 某 种 环境 中 
反复 出 现 的 问题 以 及 解决 该 问题 的 方案 的 描述 ， 比 框架 更 抽象 ; 框架 可 以 用 代码 表示 ,也 能 直 
接 执行 或 复 用 , 对 模式 而 言 只 有 实例 才能 用 代码 表示 ; 设计 模式 是 比 框 架 更 小 的 元 素 , 一 个 框 
架 中 往往 含有 一 个 或 多 个 设计 模式 , 框架 总 是 针对 某 一 特定 应 用 领域 , 但 同一 模式 却 可 适用 于 
各 种 应 用 。 框 架 是 软件 ， 而 设计 模式 是 软件 的 知识 。 简 而 言 之 : 框架 是 大 智慧 ， 用 来 对 软件 设 
计 进 行 分 工 ; 设计 模式 是 小 技巧 , 对 具体 问题 提出 解决 方案 , 以 提高 代码 复 用 率 、 降 低 耦 合 度 。 


7.1.3 RA 


MVC 的 优点 体现 在 以 下 几 个 方面 : 


CD 有 利于 团队 开发 分 工 协作 和 质量 控制 ， 降 低 开 发 成 本 。 在 开发 过 程 中 ， 可 以 更 好 地 
分 工 、 更 好 地 协作 ， 有 利于 开发 出 高 质量 的 软件 。 良 好 的 项 目 架构 设计 ， 将 减少 编码 工作 量 : 
采用 MVC 结构 + 代码 生成 器 ， 是 大 多 数 Web 应 用 的 理想 选择 。 部 分 模型 (Model) 和 存储 
过 程 一 般 可 用 工具 自动 生成 。 控 制 器 (Controller) 比较 稳定 ， 一 般 由 架构 师 〈 也 可 能 是 有 经 
验 的 人 ) 完成 。 整 个 项 目 需要 手动 编写 代码 的 地 方 只 有 视图 View) 。 在 这 种 模式 下 ， 个 人 
能 力 不 是 特别 重要 ， 只 要 懂 点 语法 基础 的 人 都 可 以 编写 , 无 论 项 目 成 员 写 出 什么 样 的 代码 , 都 
在 项 目 管理 者 的 可 控 范 围 内 。 即 使 在 项 目 中 途 换 人 ， 也 不 会 有 太 大 问题 。 在 个 人 能 力 参 差 不 齐 
的 团队 开发 中 ， 采 用 MVC 开发 是 非常 理想 的 。 
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(2) 可 以 为 一 个 模型 在 运行 时 同时 建立 和 使 用 多 个 视图 。 变 化 -传播 机 制 可 以 确保 所 有 相 
关 的 视图 及 时 得 到 模型 数据 变化 ， 从 而 使 所 有 关联 的 视图 和 控制 器 做 到 行为 同步 。 

G) 视图 与 控制 器 的 可 接 插 性 ， 人 允许 更 换 视图 和 控制 器 对 象 ， 而 且 可 以 根据 需求 动态 地 
打开 或 关闭 ， 甚 至 在 运行 期 间 进行 对 象 蔡 换 。 

(4) 模型 的 可 移植 性 。 因 为 模型 是 独立 于 视图 的 ， 所 以 可 以 把 一 个 模型 独立 地 移植 到 新 
的 平台 工作 。 需 要 做 的 只 是 在 新 平台 上 对 视图 和 控制 器 进行 新 的 修改 。 

CS) 潜在 的 框架 结构 。 可 以 基于 此 模型 建立 应 用 程序 框架 ， 不 仅仅 是 用 在 设计 界面 的 设 
计 中 。 

MVC 模式 既 有 优点 也 有 缺点 ， 总 的 来 说 还 是 优点 大 于 缺点 ， 不 然 也 不 会 出 现 MVC 模式 。 

MVC 的 不 足 体现 在 以 下 几 个 方面 : 


CD 增加 了 系统 结构 和 实现 的 复杂 性 。 对 于 简单 的 界面 ， 严 格 遵循 MVC， 使 模型 、 视 
图 与 控制 器 分 离 ， 会 增加 结构 的 复杂 性 ， 并 可 能 产生 过 多 的 更 新 操作 ， 降 低 运行 效率 。 

(2) 视图 对 模型 数据 的 访问 效率 低 。 视 图 可 能 需要 多 次 调用 Model 才能 获得 足够 的 显示 
数据 。 


(3) 完全 理解 MVC 并 不 是 很 容易 。 使 用 MVC 需要 精心 的 计划 ， 由 于 它 的 内 部 原理 比 
较 复杂 ， 因 此 需要 花费 一 些 时 间 去 思考 。 同 时 模型 和 视图 要 严格 分 离 , 给 调试 应 用 程序 带 来 了 
一 定 的 困难 。 


7.2 Spring MVC 处 理 流 程 


使 用 Java 做 Web 开发 时 有 好 多 MVC 的 框架 可 以 使 用 ， 比 如 Strut2 框架 。 由 于 Strut2 HE 
架 被 爆 出 有 安全 漏洞 ， 现 在 主流 的 是 Spring MVC. 


7.2.1 Spring MVC 引入 


要 学 习 Spring MVC， 肯 定 需要 在 项 目 中 引入 Spring MVC。 这 里 基于 Maven 创建 一 个 
webapp 的 工程 SpringMVCDemo, 并 通过 Spring MVC 在 页 面 中 输入 “Hello World" , 如 图 7-2 
所 示 。 

默认 创建 的 工程 只 有 src/main/resource 包 ， 其 他 是 不 存在 的 ， 选 中 项 目 ， 右 击 ， 选 择 “ 属 
性 ”， 在 build path 中 可 以 看 到 有 几 个 文件 不 存在 ， 需 要 的 话 可 以 按照 缺失 的 增加 。 如 果 报 图 
7-3 所 示 的 错误 ， 就 需要 配置 Tomcat 了 。 

配置 Tomcat， 首 先 需要 选中 项 目 ， 然 后 右 击 ， 选 择 properties， 再 单 击 Java Build Path 页 
面 中 Libraries 选项 卡 下 的 Add Library 按钮 ， 如 图 7-4 所 示 。 
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New Maven Project o x 
j 


New Maven project 
Select an Archetype 
Catalog: All Catalogs ~ | Configure... 
Fiter: x 
Group Id Artifact Id Version ^ 


ichemaven.archetypes maven-archetype-plugin-site 1.1 
cheamavenarchetypes maven-archetype-portlet — 1.0.1 


iche maven archetypes maven-archetype-profles ——— 10-alpha-4 
org.apachemavenarchetypes maven-archetype-quickstart — 1.1 
org.apache.maven.archetypes  maven-archetype-site. 1 
org.spachemaven.archetypes maven-archetype-site-simple — 1.1 


区 maven-a 10 9 


An archetype which contains a sample Maven Webapp project. 


E Show the last version of Archetype only [include snapshot archetypes Add Archetype... 
> Advanced 


[| error, 70 warnings, 0 others 
Description 
v @ Errors (1 item) 


@ The superclass "javax.servlet.http.HttpServlet" was not found on the Java Build Path 
> ® Warnings (70 items) 


Æ Properties for SpringMVCDemo, a x 


bape iter to Java Build Path ~o-oh 
Java Build Path a 一 一 - - ‘| 

Jevn Code Syla Source W Projects Bh Libraries % Order and Export 

Java Compiler JARs and dass folders on the build path: q 


Java Editor. ‘BA JRE System Library [J2SE-1.5] Add JARs... | 
Javadoc Location 可 Maven Dependencies | 
> JavaScript 

JISP Fragment 
> Maven 

Project Facets 

Project References 
{Refactoring History 
H Run/Debug setings 
Server 
Service Policies 
Targeted Runtimes 
Task Repository Remove F 
Task Tags 
Validation Mirate JAR Fle 
Web Content Stings i 
Web Page Editor 
Web Project Settings v [ 

> 


© [Apply and Cose] | Cancel 


选择 添加 Server Runtime, "fi; Next 按钮 ， 如 图 7-5 所 示 。 
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加 Add Library 


Add Library 
Select the library type to add. 


Connectivity Driver Definition 
CXF Runtime 

EAR Libraries 

JRE System Library 

JUnit 

Maven Managed Dependencies 
Plug-in Dependencies 


Web App Libraries 


75 

然后 选择 Tomcat， 这 里 选择 的 是 Tomcat 8.5 版 本 ， 如 图 7-6 所 示 。 
18) Add Library BH x 
Server Library = 


Select a server runtime to add to the classpath = 


Select a runtime to add to the classpath: 
B Apache Tomcat và. 


@ < Back Next > Finish Cancel 


7-6 
完整 的 目录 结构 如 图 7-7 所 示 。 
通过 上 面 的 步骤 已 经 把 项 目的 目录 结构 配置 完成 。 下 面 对 Spring MVC 进行 一 些 配置 。 如 
果 对 下 面 几 个 步骤 中 的 内 容 不 理解 也 没关系 , 这 里 只 是 先 通过 例子 对 Spring MVC 有 个 整体 的 
认识 ， 后 续 会 详细 介绍 。 
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v $3 SpringMVCDemo 


(9& src/main/resources 
(9 src/test/java 
E src/test/resources 
(9 src/main/java 
> Bh JRE System Library (/25E-1.5] 
> BA Maven Dependencies 
> BA Apache Tomcat v8.5 [Apache Tom 
vg src 
v © main 
v © webapp 
@ view 
v © WEB-INF 
因 web.xml 
B] Indexjsp 
© test 
> & target 
lij pomxml 


图 7-7 
1. 引入 依赖 


<project xmlns="http://maven.apache.org/POM/4.0.0" 


xmlns:xsi="http: //www.w3.org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 


http://maven.apache.org/maven-v4 0 0.xsd"» 


<modelVersion>4.0.0</modelVersion> 
<groupId>com.demo</groupId> 
<artifactId>SpringMVCDemo</artifactId> 
<packaging>war</packaging> 
<version>0.0.1-SNAPSHOT</version> 
«name»SpringMVCDemo Maven Webapp</name> 
<url>http://maven.apache.org</url> 


<!-- SEX maven 变量 --> 


<properties> 
<!-- spring -=> 
<spring.version>5.0.0.RELEASE</spring.version> 
«i-e dog ==> 
<commons-logging.version>1.1.3</commons-logging.version> 
<!-- Servlet --> 


<servlet.version>3.0.1</servlet.version> 
<jsp-api.version>2.2</jsp-api.version> 
€«f-- test --> 
<junit.version>3.8.1</junit.version> 

glee gdk ==> 
<jdk.version>1.8</jdk.version> 
<jstl.version>1.2</jstl.version> 
<standard.version>1.1.2</standard.version> 
<maven.compiler.plugin.version>2.3.2 


</maven.compiler.plugin.version> 
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</properties> 
<dependencies> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-beans</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-jdbc</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-expression</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-web</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-webmve</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-tx</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<dependency> 
XgroupId»javax.servlet«/groupId» 

<artifactId>jstl</artifactId> 
<version>${jstl.version}</version> 
</dependency> 
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<dependency> 
<groupId>taglibs</groupId> 
<artifactId>standard</artifactId> 
<version>${standard.version}</version> 
</dependency> 
<!-- Servlet --> 
<dependency> 
<groupId>javax.servlet</groupId> 
<artifactId>javax.servlet-api</artifactId> 
<version>${servlet.version}</version> 
<scope>provided</scope> 
</dependency> 
<dependency> 
<groupId>javax.servlet.jsp</groupId> 
<artifactId>jsp-api</artifactId> 
<version>${jsp-api.version}</version> 
<scope>provided</scope> 
</dependency> 
<!-- test --> 
<dependency> 
<groupId>junit</groupId> 
<artifactId>junit</artifactId> 
<version>${junit.version}</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
<build> 
<plugins> 
<!-- define the project compile level --> 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler-plugin</artifactId> 
<version>${maven.compiler.plugin.version}</version> 
<configuration> 
<source>${jdk.version }</source> 
<target>${jdk.version}</target> 
</configuration> 
</plugin> 
</plugins> 
<finalName>SpringMVCDemo</finalName> 
</build> 
</project> 


2. 创建 Controller 


在 com.demo.Controller 包 里 创建 ndexController。 
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package com.demo.Controller; 

import javax.servlet.http.HttpServletRequest; 

import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.servlet.ModelAndView; 


(Controller 
GRequestMapping ("/index") 
public class IndexController ( 


GRequestMapping (value="/hello.do") 


public ModelAndView getTest (HttpServletRequest request) { 
ModelAndView modelAndView = new ModelAndView ("HelloWorld"); 
return modelAndView; 


) 
3. 创建 View 


在 webapp/view 目录 下 创建 HelloWorld.jsp。 在 body 中 输出 “Hello World!" o 


<%@ page language-"java" contentType="text/html; charset=ISO-8859-1" 
pageEncoding-"ISO-8859-1"$» 

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"» 

«html» 

<head> 

<meta http-equiv-"Content-Type" content-"text/html; charset=ISO-8859-1"> 

<title>Insert title here</title> 

</head> 

<body> 

Hello World! 

</body> 

</html> 


4. ME spring-context.xml, spring-mvc.xml 
在 src/main/resources 包 下 创建 spring-context.xml, spring-mvc.xml. 


spring-context.xml: 


<?xml version-"1.0" encoding-"UTF-8"?» 
<beans xmlns-"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xmlns:mvc-"http://www.springframework.org/schema/mvc" 
xmlns:context-"http://www.springframework.org/schema/context" 
xmlns:tx-"http://www.springframework.org/schema/tx" 
xmlns:util-"http://www.springframework.org/schema/util" 
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xmlins:aop-"http://www.springframework.org/schema/aop" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/mvc 
http://www.springframework.org/schema/mvc/spring-mvc.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd 
http://www.springframework.org/schema/util 
http://www.springframework.org/schema/util/spring-util.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd"» 
<!-- 注解 注册 --> 
<context:annotation-config /> 
<context:component-scan base-package="com.demo.Controller" /> 
</beans> 


spring-mvc.xml: 


<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:context-"http://www.springframework.org/schema/context" 
xmlns:aop-"http://www.springframework.org/schema/aop" 
xmlns:mvc-"http://www.springframework.org/schema/mvc" 
xmlns:p-"http://www.springframework.org/schema/p" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd 
http://www.springframework.org/schema/mvc 
http://www.springframework.org/schema/mvc/spring-mvc.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd"» 
<!-- 自动 扫描 的 包 名 --> 
<context:component-scan base-package="com.demo.Controller" /> 
<!-- 默认 的 注解 映射 的 支持 --> 
«mvc:annotation-driven» 
<mvc:message-converters> 
<bean class="org.springframework.http.converter. 
StringHttpMessageConverter" /> 
<bean 
class-"org.springframework.http.converter. 
ResourceHttpMessageConverter" /» 
</mvc:message-converters> 
</mvc:annotation-driven> 
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<bean id-"viewResolver" 


class="org.springframework.web.servlet.view. 
InternalResourceViewResolver"> 


<property name="viewClass" 
value-"org.springframework.web.servlet.view.JstlView" /> 
<property name="prefix" value="/view/" /> 


<property name="suffix" value=".jsp" /> 
</bean> 


«mvc:default-servlet-handler /> 
</beans> 


5. fic web.xml 


<?xml version="1.0" encoding-"UTF-8"?» 
<web-app xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app 3 0.xsd" 
id="WebApp ID" version="3.0"> 
<display-name>SpringMVCDemo</display-name> 
<!-- 指定 Spring Bean 配置 文件 所 在 的 目录 ， 默 认 配置 在 WEB-INF 目录 下 --> 
<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath: spring-content.xml</param-value> 
</context-param> 
<!-- Spring 配置 --> 
<listener> 
<listener-class>org.springframework.web.context. 
ContextLoaderListener</listener-class> 
</listener> 


<!-- Spring MVC 配置 --> 
<servlet> 
<servlet-name>spring</servlet-name> 


<servlet-class>org.springframework.web.servlet.DispatcherServlet 
</servlet-class> 


<!-- 可 以 自 定义 servlet .xml 配置 文件 的 位 置 和 名 称 ， 默 认为 WEB-INF 目录 下 ， 名 称 
Al<servlet-name>]-servlet.xml, Ml spring-servlet.xml --> 
<init-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath: spring-mvc.xml</param-value> 
</init-param> 


<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>spring</servlet-name> 
<url-pattern>*.do</url-pattern> 
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</servlet-mapping> 


<!-- 中 文 过 滤器 --> 
<filter> 
<filter-name>CharacterEncodingFilter</filter-name> 
<filter-class>org.springframework.web.filter. 
CharacterEncodingFilter</filter-class> 
<init-param> 
<param-name>encoding</param-name> 
<param-value>UTF-8</param-value> 
</init-param> 
<init-param> 
<param-name>forceEncoding</param-name> 
<param-value>true</param-value> 
</init-param> 
</filter> 
<filter-mapping> 
<filter-name>CharacterEncodingFilter</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
</web-app> 


6. 启动 运行 


选中 项 目 run as， 部 署 到 tomcat H, 在 浏览 器 输入 “http://localhost:8080/SpringMVCDemo/ 
index/hello.do”， 会 在 页 面 上 出 现 “Hello World!”， 如 图 7-8 所 示 。 


c => oO Q (p lecalhost8080/SpringMVCDemo/index/hello.do 


Hello World! 


E 7-8 
7.2.2 ”处 理 流程 


不 管 是 什么 Web 框架 都 要 解决 一 个 问题 ,就 是 怎么 将 浏览 器 输入 的 url 字符 串 转换 成 眼前 
看 到 的 html 页 面 ， 知 道 它 的 处 理 流程 。 学 习 Spring MVC 框架 也 是 一 样 的 ， 在 上 节 的 例子 中 
通过 一 系列 的 配置 在 浏览 器 输出 了 “Hello World!”， 为 什么 经 过 上 面 的 配置 之 后 在 浏览 器 输 
入 url 就 会 有 显示 呢 ? 本 节 了 解 一 下 Spring MVC 的 处 理 流程 ， 以 解决 这 个 疑惑 。 一 图 项 干 言 ， 
下 面 就 用 数据 、 用 图 说 话 。 图 7-9 所 示 是 Spring MVC 的 工作 原理 。 我 们 可 以 通过 下 面 的 11 
个 步骤 来 了 解 Spring MVC 的 整个 流程 。 
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图 7-9 


da) 用 户 发 送 请 求 至 前 端 控制 器 DispatcherServlet。 

从 DispatcherServlet 的 后 级 也 能 发 现 DispatcherServlet 其 实 就 是 一 个 Servlet， 所 以 在 
web.xml 中 的 配置 也 与 Servlet 的 配置 类 似 。 其 中 ，<context-param> 元 素 配 置 了 Servlet 容器 的 
EFX, 参数 contextConfigLocation=spring-contentxml。<servle 人 元 素 配置 了 servlet-class， 值 
为 org.springframework.web.servlet.DispatcherServlet， 初 始 化 参数 contextConfigLocation 指向 
spring-mvc.xml， 作 为 Servlet 的 上 下 文 。 这 里 spring-content.xml 是 Servlet 容器 的 上 下 文 ， 
spring-mvc.xml 是 Servlet 的 上 下 文 (也 是 Spring MVC 框架 的 上 下 文 ) 。 在 spring-mvc.xml 中 
可 以 配置 自动 扫描 包 名 、 默 认 注解 映射 支持 、 视 图 解释 类 、 拦 截 器 、 对 静态 资源 文件 的 访问 等 
信息 ， 这 些 会 在 Tomcat 进行 参数 初始 化 的 时 候 实例 化 完成 。 在 DispatcherServlet 中 维护 着 一 
个 表 ， 存 放 的 是 HandlerMapping 对 象 list。 下 面 截取 的 是 DispatcherServlet 中 的 部 分 代码 ， 在 
DispatcherServlet 中 维护 着 handerMappings、handerAdapters 等 对 象 列表 。 在 initStrategies 中 对 
上 面 的 一 些 属性 进行 初始 化 。 


private LocaleResolver localeResolver; 
/** ThemeResolver used by this servlet */ 


Bullable 
private ThemeResolver themeResolver; 


Ə | @wllable 
private List<HandlerMapping> handlerMappings; 


BNullable 
private List<Handleradapter> handlerAdapters; 


/** List of HandlerExceptionResolvers used by this servlet */ 
[ Biullable 
private List<HandlerExceptionResolver> handlertxceptionResolvers; 


/** RequestToViewlameTranslator used by this servlet */ 
@ullable 
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客户 端 发 出 请 求 ， 由 Tomcat 接收 这 个 请 求 ， 如 果 匹 配 DispatcherServlet 在 web.xml 中 配 
置 的 映射 路 径 ，Tomcat 就 将 请 求 转交 给 DispatcherServlet 处 理 。 


protected void initStrategies(ApplicationContext context) { 
initMultipartResolver (context) ; 
initLocaleResolver (context); 
initThemeResolver (context); 
initHandlerMappings (context); 
initHandlerAdapters (context); 
initHandlerExceptionResolvers (context); 
initRequestToViewNameTranslator (context); 
initViewResolvers (context); 
initFlashMapManager (context); 

} 


(2) DispatcherServlet 收 到 请 求 调用 HandlerMapping 处 理 器 映射 器 。 
DispatcherServlet 的 本 质 也 是 Servlet, 运行 过 程 与 Servlet 请 求 是 一 样 的 ， 只 是 在 处 理 请 求 
的 时 候 会 调用 DispatcherServlet 中 的 doDispatch 方法 来 做 分 发 请 求 处 理 。 具 体 实现 可 以 查看 
org.springframework.web.servlet.DispatcherServlet 里 面 的 源码 。 


Protected void doDispatch (HttpServletRequest request, 
HttpServletResponse response) throws Exception { 


HttpServletRequest processedRequest 
HandlerExecutionChain mappedHandler = null; 


request; 
boolean multipartRequestParsed = false; 


WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager 
(request) ; 


try { 
ModelAndView mv = null; 
Exception dispatchException = null; 


try { 
processedRequest = checkMultipart (request) ; 
multipartRequestParsed = (processedRequest != request); 


// Determine handler for the current request. 

mappedHandler = getHandler (processedRequest) ; 

if (mappedHandler == null) { 
noHandlerFound(processedRequest, response); 
return; 


// Determine handler adapter for the current request. 
HandlerAdapter ha - getHandlerAdapter (mappedHandler. 
getHandler()); 
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// Process last-modified header, if supported by the handler. 
String method = request.getMethod(); 
boolean isGet - "GET".equals (method); 
if (isGet || "HEAD".equals(method)) { 
long lastModified - ha.getLastModified(request, 
mappedHandler.getHandler()); 
if (logger.isDebugEnabled()) ( 
logger.debug("Last-Modified value for [" + 
getRequestUri(request) + "] is: " + lastModified); 
) 
if (new ServletWebRequest (request, 
response).checkNotModified(lastModified) && isGet) ( 
return; 


) 


if (!mappedHandler.applyPreHandle (processedRequest, 
response)) { 
return; 
) 


// Actually invoke the handler. 
mv - ha.handle(processedRequest, response, 
mappedHandler.getHandler()); 


if (asyncManager.isConcurrentHandlingStarted()) ( 
return; 
) 


applyDefaultViewName (processedRequest, mv); 
mappedHandler.applyPostHandle (processedRequest, response, 
mv); 
} 
catch (Exception ex) { 
dispatchException = ex; 
} 
catch (Throwable err) { 
// Bs of 4.3, we're processing Errors thrown from handler 
methods as well, 
// making them available for @ExceptionHandler methods and 
other scenarios. 
dispatchException = new NestedServletException ("Handler 
dispatch failed", err); 
} 
processDispatchResult (processedRequest, response, mappedHandler, 
mv, dispatchException) ; 
} 
catch (Exception ex) { 
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triggerAfterCompletion(processedRequest, response, 
mappedHandler, ex); 
H 
catch (Throwable err) ( 
triggerAfterCompletion(processedRequest, response, 
mappedHandler, 
new NestedServletException("Handler processing failed", err)); 
H 
finally ( 
if (asyncManager.isConcurrentHandlingStarted()) ( 
// Instead of postHandle and afterCompletion 
if (mappedHandler !- null) ( 
mappedHandler.applyAfterConcurrentHandlingStarted 
(processedRequest, response); 
) 
) 
else ( 
// Clean up any resources used by a multipart request. 
if (multipartRequestParsed) ( 
cleanupMultipart (processedRequest) ; 


) 
(35 处 理 器 映射 器 找到 具体 的 处 理 器 Handler. 
处 理 器 映射 器 找到 具体 的 处 理 器 Handler (可 以 根据 xml 配置 、 注 解 进行 查找 ， 这 里 的 


Handler 其 实 指 的 就 是 Controller) ， 生 成 处 理 器 对 象 及 处 理 器 拦截 器 〈 如 果 有 则 生成 ) 一 并 返 
给 DispatcherServlet。 


T] 


mappedHandler = getHandler (processedRequest) ; 


if (mappedHandler == null) { 
noHandlerFound (processedRequest, response) ; 
return; 


} 


上 面 的 代码 调用 getHandler 方法 来 获取 具体 的 处 理 器 ， 下 面 给 出 getHandler 的 具体 实现 ， 
了 一 个 HandlerExecutionChain 类 型 的 对 象 。 


= 


` wey 
从 中 可 以 看 出 它 返 

17] 7 
nullable 
protected HandlerExecutionChain getHandler (HttpServletRequest request) throws Exception 

if (this.handlerMappings != null) { 
for (HandlerMapping fim : this.handlerMappings) { 
if (logger.isTraceEnabled()) { 
logger .trace( 
"Testing handler map [" + fig + "] in DispatcherServlet with name 


+ getServietName() + "'7); 
HandlertxecutionChain handler = fill. getHandler(request); 
if (handler != null) { 
return handler; 
Y 


H 


return null; 
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HandlerExecutionChain 对 象 包含 一 个 handler 和 多 个 HandlerInterceptor (拦截 器 ) 。 这 和 
ASP.NET 中 的 管道 模型 有 点 类 似 , 一 个 httphandler 和 多 个 httpmodule。 httpmodule 也 是 用 来 做 
拦截 操作 的 , 我 们 可 以 转 到 定义 中 查看 HandlerExecutionChain 的 数据 结构 (如 下 所 示 ) 。Spring 
MVC 的 拦截 器 实现 原理 就 是 通过 HandlerExecutionChain 对 象 的 HandlerInterceptor 进行 拦截 。 


37 * üsee HandlerInterceptor 

38 */ 

39 public class HandlerExecutionChain { 

40 

41 private static final Log Logger = LogFactory.getLog(HandlertxecutionChain.class) 
42 

43 private final Object handler; 

44 

ase GNullable 

46 private HandlerInterceptor[] interceptors; 

47 

m @Nullable 

49 private List<HandlerInterceptor> interceptorList; 
5e 

51 private int interceptorindex = -1; 

52 

53 

549 / 

55 * Create a new HandlertxecutionChain. 

56 * @param handler the handler object to execute 
57 */ 

589 public HandlertxecutionChain(Object handler) { 
59 this(handler, (HandlerInterceptor[]) null); 


(4) DispatcherServlet 调用 HandlerAdapter 处 理 器 适配器 。 
前 面 几 步 通 过 映射 找到 对 应 的 Controller 和 拦截 器 ， 是 找 的 过 程 ， 找 到 之 后 需要 先 将 处 理 
器 Handler 包装 成 适配器 ， 这 样 就 可 以 支持 多 种 类 型 的 处 理 器 ， 然 后 就 是 执行 的 过 程 。 


HandlerAdapter ha = getHandlerAdapter (mappedHandler.getHandler()); 


(5) HandlerA dapter 经 过 适 配 调用 具体 的 处 理 器 Handler (Controller， 也 叫 后 端 控制 器 ) o 
(6) Controller 执行 完成 ， 返 回 ModelAndView。 
(7) HandlerAdapter 将 controller 执行 结果 ModelAndView 返回 给 DispatcherServlet。 


String method = request.getMethod() ; 
boolean isGet = "GET".equals (method) ; 
if (isGet || "HEAD".equals(method)) { 
long lastModified = ha.getLastModi fied (request, mappedHandler.getHandler()); 
if (logger.isDebugEnabled()) ( 
logger .debug ("Last-Modified value for [" + getRequestUri (request) + 
"] is: " + lastModified); 
} 
if (new ServletWebRequest (request, response) .checkNotModified 
(lastModified) && isGet) { 
return; 


) 


if (!mappedHandler.applyPreHandle (processedRequest, response)) { 
return; 
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// Actually invoke the handler. 


mv = ha.handle(processedRequest, response, mappedHandler.getHandler()); 


上 面 的 几 行 代码 先 判断 如 果 是 get 请 求 就 更 新 lastModified 请 求 头 ， 然 后 执行 
HandlerExecutionChain 中 的 applyPreHandle 这 个 方法 。 我 们 来 看 一 下 applyPreHandle 的 具体 实 
现 以 及 applyPreHandle 方法 中 调用 的 triggerAfterCompletion 方法 。 


boolean applyPreHandle (HttpServletRequest request, HttpServletResponse 
response) throws Exception { 
HandlerInterceptor[] interceptors = getInterceptors(); 
if (!ObjectUtils.isEmpty(interceptors)) { 
for (int i = 0; i < interceptors.length; i++) { 
HandlerInterceptor interceptor = interceptors[i]; 
if ! interceptor .preHandle (request, response, this.handler) ) { 
triggerAfterCompletion(request, response, null); 
return false; 
} 


this.interceptorIndex = i; 


} 
return true; 
} 
void triggerAfterCompletion(HttpServletRequest request, 
HttpServletResponse response, GNullable Exception ex) 
throws Exception ( 


HandlerInterceptor[] interceptors - getInterceptors(); 
if (!ObjectUtils.isEmpty(interceptors)) ( 
for (int i - this.interceptorIndex; i »- 0; i--) ( 
HandlerInterceptor interceptor - interceptors[i]; 
try í 
interceptor.afterCompletion (request, response, 
this.handler, ex); 
) 
catch (Throwable ex2) ( 


logger.error("HandlerInterceptor.afterCompletion threw 
exception", ex2); 


) 


在 applyPreHandle 中 它 会 遍历 该 HandlerExecutionChain 中 所 有 的 拦截 器 ， 然 后 使 用 拦截 
器 通过 preHandle 方法 对 handler 进行 预 处 理 ， 如 果 所 有 的 拦截 器 都 能 处 理 就 继续 往 下 执行 ， 
一 旦 有 一 个 拦截 器 不 能 处 理 ， 就 没 必要 往 下 走 了 ， 就 会 触发 triggerAfterCompletion 方法 。 在 
triggerAfterCompletion 中 它 是 倒序 遍历 拦截 器 的 ， 执 行 完 triggerAfterCompletion 返回 false 之 
后 ，doDispatch 方法 就 执行 结束 了 ，8~11 步 就 不 再 执行 了 。 
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(8) DispatcherServlet 将 ModelAndView 传 给 ViewReslover 视图 解析 器 。 
(9) ViewReslover 解析 后 返回 具体 View. 


applyDefaultViewName (processedRequest, mv); 
mappedHandler.applyPostHandle (processedRequest, response, mv); 


1£ applyDefault ViewName 中 会 找到 ModelAndView 对 应 的 viewname, 设置 成 它 的 属性 值 。 
在 applyPostHandle 中 会 执行 拦截 器 的 postHandle 方法 。 这 里 的 applyPostHandle 与 第 7 步 的 
applyPreHandle 分 别 会 执行 HandlerInterceptor 的 postHandle 和 preHandle 方法 。 自 定义 拦截 器 
里 面 的 方法 就 是 在 第 7 步 和 第 9 步 被 调用 的 。 
(10) DispatcherServlet 根据 View 进行 泻 染 视图 〈 将 模型 数据 填充 至 视图 中 ) 。 
processDispatchResult (processedRequest, response, mappedHandler, mv, 
dispatchException) ; 
在 processDispatchResult 方法 中 有 一 句 render(mv, request, response), 在 render 方法 中 先是 
获取 View 对 象 ， 然 后 调用 “view.render(mv.getModelInternal(), request, response);”， 将 view 
和 model 绑 定 来 泻 染 视图 。 


(11) DispatcherServlet 响应 用 户 。 
在 父 类 FrameworkServlet 的 processRequest 方 法 中 执行 publishRequestHandledEvent(request, 
response, startTime, failureCause) 方 法 ， 将 结果 响应 给 用 户 。 


HandlerMapping 的 使 用 


在 com.demo.Controller 包 的 IndexController 类 中 使 用 注解 @RequestMapping 配置 在 
IndexController 类 和 getTest 方法 上 之 后 就 可 以 在 url 中 输入 @RequestMapping 注解 的 值 执行 
getTest 方法 ， 那 它 是 怎么 实现 的 呢 ? 这 就 要 了 解 HandlerMapping 的 使 用 了 。 图 7-10 所 示 是 
HandlerMapping 接口 的 API 文档 ， 可 以 看 到 该 接口 有 好 几 个 实现 类 。 


org.springtramework web.serviet 


Interface HandlerMapping 


‘All Known Subintertaces: 
MatchableHandlenMapping 


All Known Implementing Classes: 


AbstractDetectingUrlHandlerMapping, AbstractHandlerMapping, AbstractHandlerMethodMapping, AbstractUrlHandlerMapping, BeanNameUrlHandlerMapping, 
RequestMappingHandlerMapping, RequestMappingInfoHandlerMapping, SimpleUrlHandlerMapping, WebSocketHandlerMapping 


7-10 
HandlerMapping 接口 几 个 实现 类 之 间 的 关系 可 以 用 UML 类 图 表示 出 来 ， 如 图 7-11 所 示 。 
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7-11 


在 HandlerMapping 的 实现 类 中 常用 的 有 3 个 ， 分 别 是 RequestMappingHandlerMapping, 
BeanNameUrlHandlerMapping 和 SimpleUrlHandlerMapping o 


7.3.4 RequestMappingHandlerMapping 


RequestMappingInfoHandlerMapping 和 AbstractHandlerMethodMapping 都 是 抽象 类 ， 实 际 
上 最 终 还 是 用 的 RequestMappingHandlerMapping， 使 用 注解 的 时 候 ， 通 过 注解 将 url 映射 到 对 
应 的 Controller 上 。 


[** 

Creates {@link RequestMappingInfo} instances from type and method-level 
{@link RequestMapping @RequestMapping} annotations in 

* (Glink Controller @Controller} classes. 


* @author Arjen Poutsma 

* @author Rossen Stoyanchev 

* @author Sam Brannen 

* @since 3.1 

aa 

public class RequestMappingHandlerMapping extends 
RequestMappingInfoHandlerMapping 
implements MatchableHandlerMapping, EmbeddedValueResolverAware { 
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在 上 面 的 IndexController 类 中 ,就 是 使 用 的 RequestMappingHandlerMapping 来 将 url 映射 
到 getTest 方 法 上 的 。 


7.3.2 BeanNameUrlHandlerMapping 


BeanNameUrlHandlerMapping 通过 bean 将 url 映射 到 对 应 的 Controller， 需 要 在 spring- 
mvc.xml 中 配置 BeanNameUrlHandlerMapping 以 及 bean 对 应 的 Controller. Controller 要 继承 
AbstractController. 


package com.demo.Controller; 


import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.springframework.web.servlet .ModelAndView; 
import org.springframework.web.servlet.mvc.AbstractController; 
public class HelloController extends AbstractController{ 
@Override 
protected ModelAndView handleRequestInternal (HttpServletRequest request, 


HttpServletResponse response) 
throws Exception { 


return new ModelAndView ("HelloWorld"); 


} 
在 spring-mvc.xml 中 配置 bean， 将 url 映射 到 对 应 的 Controller。 


<bean class="org.springframework.web.servlet.handler. 
BeanNameUrlHandlerMapping"»«/bean» 


<bean id-"/hello.do" class="com.demo.Controller.HelloController"> 
</bean> 


在 浏览 器 中 输入 “url: — http://localhost:8080/SpringMVCDemo/hello.do ”， 可 以 将 
HelloWorld.jsp 页 面 的 内 容 输出 ， 如 图 7-12 所 示 。 


= O q 


Hello World! 


El 7-12 


7.3.3 SimpleUrlHandlerMapping 


BeanNameUrlHandlerMapping 是 通过 bean 的 名 字 来 实现 handler 映射 的 。 
SimpleUrlHandlerMapping 则 是 通过 url 来 实现 handler 的 映射 ， 有 两 种 常见 的 映射 方法 : 一 是 
通过 prop key， 二 是 通过 value. 


151 


Spring 快速 入 门 


这 里 还 是 使 用 HelloController， 在 spring-mvc.xml 中 的 配置 可 以 使 用 props 元 素来 进行 配 
置 。prop 标签 中 的 key 都 是 url 值 ， 后 面 的 为 BeanID， 如 果 我 们 在 地 址 栏 中 输入 的 url 与 key 
匹配 ， 则 分 发 到 prop 标签 中 指定 的 beanID 所 指定 的 Controller。 


<bean id="helloController" class="com.demo.Controller.HelloController" /> 
<bean class="org.springframework.web.servlet.handler. 
SimpleUrlHandlerMapping"> 
<property name="mappings"> 
<props> 
<prop key-"/hello.html"»helloController«/prop» 
</props> 

</property> 

</bean> 


value 元 素 和 prop key 类 似 ， 通 过 url=bean 的 形式 将 浏览 器 输入 的 url 与 xml 中 配置 的 
Controller 进行 映射 。 


<bean id="helloController" class="com.demo.Controller.HelloController" /> 
<bean class-"org.springframework.web.servlet.handler. 
SimpleUrlHandlerMapping"> 
<property name="mappings"> 
<value> 
/*/hello.html-helloController 

«/value» 

</property> 
</bean> 


两 种 方式 都 可 以 通过 输入 “http:/localhost:8080/SpringMVCDemo/hello.html ”将 
HelloWorld.jsp 页 面 的 内 容 输出 。 


传递 数据 到 Controller 


MVC 框架 都 要 解决 url 映射 问题 、 数 据 交 互 问题 ， 上 一 节 介 绍 了 url 映射 问题 ， 从 本 节 开 
始 来 介绍 数据 交互 问题 。MVC 中 数据 传递 主要 分 为 从 url 到 Controller、 从 view 到 Controller、 
Controller 到 view 以 及 Controller 之 间 的 数据 传递 几 个 部 分 。 


7.4.1 URL 传递 数据 到 Controller 


在 浏览 器 输入 的 url 有 时 会 带 间 号 ,问号 之 后 用 & 取 地 址 符 连接 name=value, 在 Spring MVC 
中 这 些 参数 Controller 是 用 什么 接收 的 呢 ? Controller 接收 参数 主要 用 @RequestParam 和 
@PathVariable。 这 里 在 webapp/view 目录 下 新 建 index.jsp 页 面 ， 在 里 面 添 加 一 个 表单 ， 用 来 
输入 用 户 名 和 密码 。 
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<%@ page language-"java" contentType-"text/html; charset=utf-8" 
pageEncoding-"utf-8"$» 

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"» 

«html» 

<head> 

<meta http-equiv="Content-Type" content-"text/html; charset=utf-8"> 

<title>Insert title here</title> 

</head> 

<body> 


<form id="form1" name="myform" method="post" action="login.do" > 
用 户 :<input type="text" name="name"/> 
密码 :<input type="password" name="pwd"/> 
<input type="submit"/> 

</form> 

</body> 

</html> 


1. @RequestParam 


常见 的 url 中 会 是 “?name=XXX&pwd=XXX” 这 种 ， 如 果 想 获取 “name,pwd”， 可 以 使 
用 @RequestParam。 假 如 是 可 选 参数 ， 可 以 设置 required=false， 默 认 是 true, value 也 要 与 url 
的 对 应 。 


@RequestMapping (value="/login.do") 
public ModelAndView login(HttpServletRequest request, 
HttpServletResponse response, @RequestParam("name") String name, 
@Request Param (value="pwd", required=false) String pwd) { 
ModelAndView modelAndView = new ModelAndView ("Index") ; 
System. out.printl1n("name:"+name+" pwd:"+pwd) ; 
return modelAndView; 
} 


在 浏览 器 中 输入 “http:Wlocalhost8080/SpringMVCDemo/index/login.do?name=test&pwd= 
123456” , Controller 就 会 将 name 和 pwd 输出 到 控制 台 ， 并 将 index.jsp 页 面 显 示 出 来 。 


2. @PathVariable 
有 的 url 的 格式 是 url/param1/param2， 这 种 获取 值 可 以 使 用 @PathVariable。 


@RequestMapping (value="/getlogin/{name}/{pwd}", 
method=RequestMethod. GET) 
public ModelAndView getlogin(HttpServletRequest request, 
HttpServletResponse response, @PathVariable("name") String name, 
@PathVariable ("pwd") String pwd) { 
ModelAndView modelAndView = new ModelAndView ("Index"); 
System. out.println("name:"+name+" pwd:"+pwd) ; 
return modelAndView; 
} 
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在 浏览 器 中 输入 “http://localhost:8080/SpringMVCDemo/index/getlogin/test/123456 ”， 


Controller 同样 会 将 name 和 pwd 输出 到 控制 台 并 显示 index jsp 页 面 。 
7.4.2. View 传递 数据 到 Controller 


上 面 是 通过 url 传递 参数 到 Controller 中 , 通常 用 户 是 通过 页 面 View 填充 数据 之 后 发 送 到 


服务 端 ， 从 View 传递 数据 到 Controller 主要 有 3 种 方式 : 直接 将 请 求 参 数 名 作为 Controller 
中 方法 的 形 参 、 使 用 Pojo 对 象 和 使 用 原生 的 Servlet API 作为 Controller 方法 的 参数 。 


1. 直接 将 请 求 参数 名 作为 Controller 中 方法 的 形 参 
这 里 定义 了 login2 方法 ， 用 于 接收 login.do 的 post 请 求 ， 形 参 name. pwd 用 来 接收 表单 


提交 到 Controller 中 的 数据 。 在 index.jsp 中 输入 用 户 名 、 密 码 之 后 ， 单 击 “ 提 交 ” 按 钮 ， 在 控 
制 台中 可 以 看 到 从 view 中 传 入 的 name 和 pwd. 


@RequestMapping (value="/login.do",method=RequestMethod. POST) 
public ModelAndView login2(HttpServletRequest request, 


HttpServletResponse response,String name,String pwd) { 


ModelAndView modelAndView = new ModelAndView ("Index") ; 
System. out.println("name:"+name+" pwd:"+pwd) ; 

return modelAndView; 

} 


2. 使 用 Pojo HR 
如 果 请 求 参数 有 好 多 个 ， 都 放 在 Controller 方法 的 形 参 中 时 函数 会 很 长 ， 一 般 情况 下 会 把 


参数 封装 成 对 象 进行 传递 。Spring MVC 会 按 请 求 参数 名 和 POJO 属性 名 进行 自动 匹配 ， 自 动 
为 该 对 象 填充 属性 值 ， 支 持 级 联 属性 ， 如 address.province、address.city 等 。 


为 了 演示 如 何 使 用 Pojo 对 象 ， 首 先 在 com.demo.model 包 中 定义 User 对 象 ， 该 对 象 中 有 


两 个 属性 一 一 name 和 pwd。 


package com.demo.model; 
public class User { 
private String name; 
private String pwd; 
public String getName() { 
return name; 
} 
public void setName (String name) { 
this.name = name; 
} 
public String getPwd() { 
return pwd; 
H 
public void setPwd(String pwd) ( 
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this.pwd = pwd; 


} 
在 Controller 中 可 以 使 用 User 来 接收 View 传 过 来 的 参数 。 


@RequestMapping (value="/login.do",method=RequestMethod. POST) 
public ModelAndView login3 (HttpServletRequest 
request,HttpServletResponse response,User user) { 
ModelAndView modelAndView = new ModelAndView ("Index") ; 


System. out.println("name:"+user.getName()+" pwd:"-*user.getPwd()); 
return modelAndView; 


} 
3. 使 用 原生 的 Servlet API 作为 Controller 方法 的 参数 


不 仅 是 通过 view 传 到 Controller, url 传 参 数 到 Controller 也 一 样 。 既 然 有 HttpServletRequest， 
我 们 可 以 通过 request 对 象 获 取 相 关 参 数 。 


String username=request.getParameter ("name") ; 
System. out.printin ("username:"+username) ; 
String pwd=request.getParameter ("pwd") ; 
System. out.print1n ("pwd:"+pwd) ; 


-— -— *. e. 
了 .与 ”传递 数据 到 View 


上 一 节 介绍 了 如 何 从 url 或 view 中 向 Controller 传递 数据 ， 是 用 户 输入 的 过 程 ， 本 节 介 绍 
如 何 从 Controller 向 View 传递 数据 ， 是 向 用 户 输出 的 过 程 。 数 据 主 要 通过 ModelAndView、 
Model / Map / ModelMap. @SessionAttributes. @Model Attribute 这 几 种 方式 传递 给 View. 


7.5.4 ModelAndView 


在 前 面 Controller 方法 中 都 是 通过 new ModelAndView("Index") 仅 是 返回 视图 ， 其 实 如 果 
转 到 ModelView 类 里 面 可 以 看 到 该 类 还 有 一 个 继承 自 LinkedHashMap 的 ModelMap 类 型 的 
model 属性 ， 可 以 通过 该 属性 来 传 参 数 到 View 中 。 


GRequestMapping (value="/login.do",method=RequestMethod. POST) 
public ModelAndView login4(HttpServletRequest request, 
HttpServletResponse response, User user) { 
ModelAndView modelAndView = new ModelAndView ("Index") ; 
modelAndView.addObject ("user", user); 
return modelAndView; 
} 


155 


Spring 快速 入 门 


使 用 addObject 方法 ， 往 hashmap 中 put 了 一 个 key=user，value=user 的 对 象 ， 之 后 就 可 
以 在 View 中 获取 到 。 在 index.jsp 的 body 体 中 增加 下 面 两 行 获取 user 对 象 属性 的 代码 ， 当 用 
户 在 页 面 提交 之 后 就 可 以 看 到 提交 的 内 容 ， 如 图 7-13 所 示 。 

姓名 : ${user.name}<br> 
密码 :$ {user .pwd}<br> 


图 7-13 


在 Controller 中 的 方法 入 参 如 果 为 org.springframework.ui.Model. Java.uti.Map 或 
org.springframework.ui.ModelMap， 在 方法 返回 时 会 将 参数 自动 添加 到 模型 中 。 


@RequestMapping (value = "/testModel.do",method = RequestMethod. GET) 
public String testModel (Model model) { 

User user=new User (); 

user.setName ("abc") ; 

user.setPwd ("123456"); 

model.addAttribute ("user", user) ; 

return "Index"; 


} 


在 浏览 器 中 输入 “http:Wlocalhost:8080/SpringMVCDemo/index/testModeldo ”， 会 返回 
Index.jsp 页 面 ， 同 时 会 将 user 对 象 传递 到 View 中 ， 如 图 7-14 所 示 。 


localhost 


图 7-14 


7.5.2 @SessionAttributes 


@SessionAttributes 会 将 模型 中 的 某 个 属性 暂 存 到 HttpSession 中 , 以 便 多 个 请 求 之 间 可 以 
共享 这 个 属性 ， 比 如 我 们 登录 之 后 可 能 会 存 登 录 信 息 ， 就 可 以 使 用 它 。@SessionAttributes 这 
个 注解 只 能 放 到 类 的 上 面 。 

@SessionAttributes ({"user"}) 
@controller 


@RequestMapping ("/index") 
public class IndexController { 
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在 IndexController 上 面 配 置 了 @SessionAttributes， 将 attributeName 7 user 的 对 象 保存 在 
HttpSession 中 ， 这 样 其 他 地 方 也 能 获取 到 该 对 象 。 
在 HelloWorld.jsp 页 面 的 body 中 也 加 上 user RAY name. pwd 属性 的 代码 。 


姓名 :${fuser.namej<br> 
#09: ${user.pwd}<br> 


在 浏览 器 中 输入 “http://localhost:8080/SpringMVCDemo/index/testModel.do”， 将 user 对 
象 保存 在 HttpSession 中 ， 然 后 输入 url “http://localhost:8080/SpringMVCDemo/index/test.do” , 
虽然 只 是 返回 视图 ， 但 是 显示 的 页 面 也 可 以 获取 user 对 象 的 name 和 pwd, WP 7-15 所 示 。 


@RequestMapping (value="/test.do") 

public ModelAndView getTest (HttpServletRequest request) { 
ModelAndView modelAndView = new ModelAndView ("HelloWorld"); 
return modelAndView; 


DS EU RIETI localhost 808 


Hello World! 
姓名 :abc 
密码 :123456 


图 7-15 
7.5.3 @ModelAttribute 


Spring MVC 在 每 次 调用 请 求 处 理 方法 时 都 会 创建 Model 类 型 的 一 个 实例 。 如 果 准 备 使 用 
此 实例 ， 就 可 以 在 方法 中 添加 一 个 Model 类 型 的 参数 。 可 以 用 @ModelAttribute 来 注释 方法 参 
数 : 带 有 @ModelAttribute 注解 的 方法 会 将 其 输入 或 创建 的 参数 对 象 添加 到 Model 对 象 中 ( 若 
方法 中 没有 显 式 添 加 ) 。 也 可 以 用 @ModelAttribute 标注 一 个 非 请 求 的 处 理 方法 (有 返回 值 ， 
无 返回 值 ) : 被 @ModelAttribute 注释 的 方法 会 在 此 Controller 每 个 方法 执行 前 被 执行 。 


1. @ModelAttribute 注解 方法 参数 


@RequestMapping (value = "/testModelAttribute.do",method = 
RequestMethod. GET) 
public String testModelAttribute(HttpServletRequest request, 
HttpServletResponse response, @ModelAttribute ("user") User 
user, @ModelAttribute("name")String name,Model model) { 
user.setName ("abc") ; 
user.setPwd ("123456"); 
name="testModelAttribute"; 
model.addAttribute("name", name); 
return "Index"; 
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使 用 @ModelAttribute 注解 user 和 name 之 后 ， 在 testModelAttribute 方法 中 修改 了 参数 的 
值 ， 然 后 在 index.jsp 显示 出 来 , 这 里 在 index jsp 中 增加 了 name 属性 的 获取 , 在 浏览 器 中 输入 
“http://localhost:8080/SpringMVCDemo/index/testModelAttribute.do”， 结 果 如 图 7-16 所 示 。 


€ > 0 à D localhost: 

用 户 密码 | Sia | | 提交 查询 内 容 
姓名 :abc 

密码 :123456 

name-testModelAttribute 


图 7-16 
2. @ModelAttribute 标注 一 个 非 请 求 的 处 理 方法 


被 @ModelAttribute 注解 的 方法 会 在 此 Controller. 每 个 方法 执行 前 被 执行 。 被 
@ModelAttribute 注解 的 方法 还 区 分 有 返回 值 和 无 返回 值 两 种 。 


(1) 有 返回 值 方法 
在 IndexController 中 增加 了 使 用 @ModelAttribute 注解 的 方法 , 在 map() 方 法 里 面 实例 化 了 
User 对 象 ， 并 将 该 对 象 放 在 HashMap 中 返回 。 


@ModelAttribute (value = "mymap") 
public Map<String,Object> map() { 
User user=new User (); 
user.setName ("abc") ; 
user.setPwd ("123456"); 
HashMap<String, Object> map=new HashMap<String, Object>(); 
map.put ("user", user); 


return map; 
} 
在 jsp 页 面 中 获取 就 不 能 直接 用 ${fusername} 来 获取 值 ， 还 要 在 前 面 加 上 @ModelAttribute 
的 value 值 。 在 浏览 器 中 输入 url“http://localhost:8080/SpringMVCDemo/index/test.do”， 通 过 
map() 方 法 设置 的 对 象 就 能 获取 显示 出 来 ， 如 图 7-17 所 示 。 


姓名 :$ {mymap.user.name}<br> 
密码 : $ {mymap .user.pwd}<br> 


e M TA D localhost:208 


Hello World! 


7-17 


(2) 无 返回 值 方法 
有 返回 值 和 无 返回 值 最 大 的 区 别 是 无 返回 值 的 方法 需要 显 式 地 将 对 象 添加 到 model 中 。 
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@ModelAttribute 
public void voidmap(Model model) { 
User user=new User (); 
user.setName ("abcd") ; 
user.setPwd ("123456"); 
HashMap<String, Object> map=new HashMap<String, Object>(); 
map.put ("user", user) ; 
model.addAttribute ("voidmap", map) ; 
} 


在 IndexController 中 又 增加 了 一 个 无 返回 值 的 方法 voidmap， 在 方法 中 显 式 为 model 注入 
HashMap 对 象 。 然 后 在 HelloWorld. jsp 中 修改 一 下 获取 值 ， 代 码 如 下 : 


姓名 :${voidmap .user.namej<br> 
密码 :${voidmap .user.pwdj<br> 
登录 之 后 ， 在 浏览 器 中 输入 url“http:Wlocalhost:8080/SpringMVCDemo/index/testdo”， 则 
会 将 voidmap 中 的 model 对 象 显示 在 HelloWorld.jsp 页 面 中 ， 如 图 7-18 所 示 。 


c E [6] [^j localhost: 


Hello World! 
姓名 :abcd 
密码 :123456 


图 7-18 


了 © sen 


在 介绍 Spring MVC 工作 流程 时 介绍 了 HandlerExecutionChain 对 象 包含 一 个 handler 和 多 
个 HandlerInterceptor (拦截 器 ) 。 本 节 通 过 实例 了 解 一 下 Spring MVC 中 拦截 器 的 使 用 。 

我 们 平时 在 做 系统 时 有 些 页 面 是 需要 先 登 录 才 能 访问 的 , 一 种 方法 是 在 每 个 请 求 方法 中 都 
做 登录 判断 ， 这 样 顶 多 是 把 登录 功能 封装 起 来 ， 以 后 每 新 增 一 个 代码 都 要 加 上 ， 很 不 方便 。 其 
实 这 里 我 们 可 以 使 用 拦截 器 进行 登录 验证 ， 判 断 是 否 有 session, WRA session 就 断定 已 经 登 
录 。 拦 截 器 不 仅仅 可 以 做 登录 ， 登 录 完成 之 后 可 能 还 有 根据 用 户 角 色 限 制 页 面 或 工具 的 权限 ， 
我 们 还 可 以 再 增加 一 个 拦截 器 来 判断 用 户 权 限 等 。 本 节 使 用 登录 来 演示 拦截 器 的 使 用 。 


1. 新 建 拦截 器 类 


在 com.demo.model 包 下 新 建 拦截 器 LoginIntercepter 类 ， 实 现 HandlerInterceptor 接口 , 重 
写 了 preHandle 方法 。 在 preHandle 方法 中 判断 是 不 是 登录 页 面 ， 登 录 页 面 不 能 被 拦截 ， 不 然 
它 始终 登录 不 上 。 然 后 判断 是 否 有 session， 如 果 有 就 当 作 登 录 成 功 ， 没 有 就 跳 转 到 登录 页 面 。 


Package com.demo.model; 
import javax.servlet.http.HttpServletRequest; 
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import javax.servlet.http.HttpServletResponse; 

import javax.servlet.http.HttpSession; 

import org.springframework.web.servlet.HandlerInterceptor; 
public class LoginIntercepter implements HandlerInterceptor{ 


@Override 
public boolean preHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler) 
throws Exception { 
String requestURI = request.getRequestURI (); 
if(requestURI.indexOf ("/login") <=0) { 
HttpSession session = request.getSession(); 
User user= (User) session.getAttribute ("user"); 
if(user!-null)( 
// 登 录 成 功 的 用 户 
return true; 
jelse{ 
// 没 有 登录 ， 转 向 登录 界面 
request.getRequestDispatcher("../view/Index.jsp"). 
forward (request, response) ; 
return false; 


} 
jelse{ 
return true; 


} 
这 里 在 进行 页 面 跳 转 时 使 用 的 是 forward 方法 ， 还 有 一 种 页 面 跳 转 方法 forward， 下 面 给 
出 两 者 的 区 别 。 

© forward 过 程 : 转发 ， 服 务 器 端 行为 。Web 服务 器 接受 请 求 ， 调 用 内 部 的 方法 在 容器 内 部 
完成 请 求 处 理 和 转发 动作 ， 然 后 响应 客户 端 ， 在 这 里 转发 的 路 径 必须 是 同一 个 web 容器 
下 的 url， 不 能 转向 其 他 的 Web 路 径 上 去 ， 中 间 传 递 的 是 自己 容器 内 的 request。 

* redirect 过 程 : 重 定 向 ， 客 户 端 行为 。 客 户 端 发 送 HTTP 请 求 ，Web 服务 器 接受 后 发 送 3** 
状态 码 响应 及 对 应 新 的 location 给 客户 端 ， 客 户 端 发 现 是 3** 响 应 ， 则 自动 发 送 一 个 新 的 
http 请 求 ， 请 求 url 是 新 的 location 地 址 ， 在 这 里 location 可 以 重 定向 到 任意 URL, MA 
是 浏览 器 重新 发 出 了 请 求 ， 就 没有 什么 request 传递 的 概念 了 。 重 定向 行为 是 浏览 器 做 了 
至 少 两 次 的 访问 请 求 。 

2. 配置 拦截 器 


创建 之 后 还 需要 将 拦截 器 配置 到 项 目 中, 需要 在 spring-mve.xml 中 使 用 <mvc:interceptors> 
元 素 将 创建 的 拦截 器 类 配置 到 HandlerExecutionChain 中 。 


<mvc:interceptors> 
«mvc:interceptor»«mvc:mapping path="/**"/><bean 
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class="com.demo.model.LoginIntercepter"/></mvc:interceptor> 
</mvc:interceptors> 


3. 测试 
在 IndexController 中 使 用 @SessionAttributes({"user"}) 设 置 了 session 对 象 ， 当 第 一 次 在 浏 
览 器 中 输入 url“http://localhost:8080/SpringMVCDemo/index/test.do” 时 会 自动 跳 转 到 Index.jsp 


页 面 。 在 Index.jsp 页 面 输入 用 户 名 、 密 码 提 交 之 后 再 次 输入 url “http://localhost:8080/ 
SpringMVCDemo/index/test.do ”就 会 正常 显示 ， 不 会 再 跳 转 到 登录 页 面 ， 如 图 7-19 所 示 。 


D localhost:808 


密码 | 


图 7-19 


7 " 7 Ajax 5 Controller 交互 


Ajax 45 Controller 交互 主要 有 3 个 步骤 ， 引 入 静态 资源 文件 、Ajax 发 起 请 求 、Controller 
接收 请 求 并 响应 。 


1. 引入 静态 资源 文件 


前 面 学 习 了 拦截 器 , 通过 拦截 器 我 们 可 以 拦截 请 求 , 做 进一步 处 理 之 后 再 往 下 进行 , 但 是 
我 们 使 用 Ajax 的 时 候 会 有 一 个 问题 ， 就 是 会 把 js、css 这 些 静 态 资源 文件 拦截 了 ， 这 样 在 jsp 
中 就 无 法 引入 静态 资源 文件 了 。 所 以 在 spring-mvc.xml 配置 拦截 器 时 需要 进行 优化 , 将 资源 文 
件 排除 在 拦截 器 外 。 


<mvc:interceptors> 
<mvc: interceptor> 
<mvc:mapping path-"/**/*"/» 
<mvc:exclude-mapping path="/**/fonts/*"/> 
<mvc:exclude-mapping path="/**/*.css"/> 
<mvc:exclude-mapping path="/**/*.js"/> 
<mvc:exclude-mapping path="/**/*.png"/> 
«mvc:exclude-mapping path-"/**/*.gif"/» 
«mvc:exclude-mapping path-"/**/*.jpg"/» 
«mvc:exclude-mapping path-"/**/*.jpeg"/» 
«mvc:exclude-mapping path-"/**/*login*"/» 
«mvc:exclude-mapping path-"/**/*Login*"/» 
<bean class="com.demo.model.LoginIntercepter"></bean> 
</mvc:interceptor> 
</mvc:interceptors> 
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为 了 演示 Ajax 与 Controller 之 间 的 交互 , 需要 在 项 目 中 引入 js 文件 , 这 里 在 webapp 下 创 
ÆT js 文件 来， 将 jquery-3.3.1.min.js 放 在 该 文件 夹 下 。 除 了 配置 拦截 器 外 ， 还 需要 在 
spring-mve.xml 中 配置 对 静态 资源 文件 的 访问 。 

<!-- 对 静态 资源 文件 的 访问 方案 一 (二 选 一 --> 


<mvc:default-servlet-handler /> 

<!-- 对 静态 资源 文件 的 访问 方案 二 (二 选 一 ) --> 

<mvc:resources mapping="/images/**" location="/images/" 
cache-period-"31556926"/» 

«mvc:resources mapping-"/js/**" location-"/js/" 
cache-period="31556926"/> 

«mvc:resources mapping="/css/**" location="/css/" 
cache-period="31556926"/> 


2. Ajax 发 起 请 求 
在 indexjsp 中 增加 了 一 个 按钮 ， 并 为 该 按钮 增加 了 一 个 单 击 事件 ， 在 单 击 事件 中 向 服务 
端 发 起 post 请 求 。 
<%@ page language-"java" contentType="text/html; charset=utf-8" 
pageEncoding-"utf-8"$» 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"» 


<html> 

<head> 

«meta http-equiv-"Content-Type" content-"text/html; charset=utf-8"> 

<script type-"text/javascript" src="<%=request.getContextPath() %> 
/js/jquery-3.3.1.min.js"></script> 


<% 
String path = request.getContextPath(); 
String basePath = request.getScheme() + "://" 
+ request.getServerName() + ":" + request.getServerPort () 
+ path + "/"; 
$> 


<script type= "text/javascript" src= "«$-basePath %>js/ 
jquery-3.3.1.min.js"></script > 
<script type="text/javascript"> 
$ (document) . ready (function () { 
$("#btnlogin") .click (function () { 
var json = { 
'name':$(':input[name-name] ').val(), 
'pwd':$(':input[name-pwd] ').val() 
is 
var postdata = JSON.stringify (json) ;//json 对 象 转换 json 字符 串 
S.ajax({ 
type : 'POST', 
contentType : 'application/json;charset=UTF-8',// 注 意 类 型 
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processData : false, 

url : '<%=path%>/index/requestbodybind.do', 
dataType : 'json', 

data : postdata, 

success : function(data) ( 


alert('user : '*data.name*'Mnpassword : '*data.pwd); 


}, 

error : function(err) { 
console.log(err.responseText) ; 
alert (err.responseText) ; 


se 
</script> 
<title>Insert title here</title> 
</head> 
<body> 
<form id-"forml1" name="myform" method="post" action-"login.do" > 
用 户 :<input type="text" name="name"/> 
密码 :<input type="password" name="pwd"/> 
<input type="button”value=" 登 灵 "” id-"btnlogin"» <input 


type="submit"/> 


</form> 
REY :${user.name}<br> 
19: ${user.pwd}<br> 
</body> 
</html> 


3. Controller 接收 请 求 并 响应 


在 IndexController 中 使 用 requestBodyBind 方法 来 接收 User 类 型 对 象 , 打印 出 该 对 象 并 返 


。 结 果 如 图 7-20 所 示 。 

€ © © localhost8080/SpringMVCDemo/index/login.do 

FAP admin Ei localhost8080 BF 

Mtsasaa user : admin 

密码 :qqqqq password : 123456 

name: 
图 7-20 

@RequestMapping (value="/requestbodybind.do",method = 
{RequestMethod. POST} ) 


@ResponseBody 
public User requestBodyBind(@RequestBody User user) { 
System. out.printin("requestbodybind:" + user); 
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return user; 
} 


这 里 主要 是 有 两 个 注解 : @RequestBody 和 @ResponseBody。 


e (@RequestBody 作用 在 形 参 列表 上 ， 用 于 将 前 台 发 送 过 来 固定 格式 的 数据 【xml 格式 或 者 
json 等 】 封 装 为 对 应 的 JavaBean 对 象 ， 封 装 时 使 用 到 的 一 个 对 象 是 对 系统 默认 配置 的 
HttpMessageConverter 进行 解析 ， 然 后 封装 到 形 参 上 。 

© @ResponseBody 是 作用 在 方法 上 的 ，@ResponseBody 表示 该 方法 的 返回 结果 直接 写 入 
HTTP response body 中 ， 一 般 在 异步 获取 数据 时 使 用 (也 就 是 AJAX) ， 在 使 用 
@RequestMapping 后 ， 返 回 值 通常 解析 为 跳 转 路 径 ， 但 是 加 上 人 @ResponseBody 后 返回 结 
果 不 会 被 解析 为 跳 转 路 径 ， 而 是 直接 写 入 HTTP response body 中 。 比 如 异步 获取 json 数 
据 ， 加 上 (@ResponseBody 后 ,会 直接 返回 json 数据 。@RequestBody 将 HTTP 3f 4 iE x: 4& 
入 方法 中 ， 使 用 适合 的 HttpMessageConverter 将 请 求 体 写 入 某 个 对 象 。 上 面 在 
requestBodyBind 方法 中 返回 的 user 对 象 就 没有 被 解析 为 跳 转 路 径 ， 而 是 直接 写 入 HTTP 
response body 中 ， 在 ajax 响应 结果 中 解析 出 来 并 弹出 。 


在 实现 的 过 程 中 可 能 会 报 415 的 错误 ， 如 图 7-21 所 示 。 导 致 这 个 错误 是 由 于 在 pom.xml 
中 需要 引入 json 转换 相关 类 库 ， 这 里 引入 的 是 jackson-databind 包 。 


HTTP Status 415 — Unsupported Media Type 


WI status Report 
The origin server is refusing to service the request because the payload is in a format not supported by this method on the target resource. 


Ej 7-21 


«dependency» 
<groupId>com. fasterxml .jackson.core</groupId> 
<artifactId>jackson-databind</artifactId> 
<version>2.9.5</version> 

</dependency> 


了 .号 小 结 


本 章 主要 介绍 了 MVC HEW, Spring MVC 工作 流程 、view 与 Controller 之 间 的 数据 交互 等 
内 容 。 通 过 本 章 的 学 习 ， 基 本 可 以 掌握 Spring MVC 框架 的 使 用 了 。 
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本 章 学 习 Spring 家 族 中 一 个 全 新 的 框架 Spring Boot. 它 可 以 用 来 简化 Spring 应 用 程序 的 
创建 和 开发 过 程 。 


本 章 主要 涉及 的 知识 点 : 


Spring Boot 引入 : 简单 介绍 、 在 线 、 离 线 安装 。 

基本 配置 : X) Banner. BOX Xt. 

外 部 配置 : 常规 属性 配置 、 基 于 properties 类 型 安全 的 配置 。 
其 他 配置 : Profile 配置 、 日 志 配置 。 

运行 原理 : 运行 原理 介绍 。 


8.1 Spring Boot 基础 


本 节 先 了 解 一 下 Spring Boot 基础 知识 ， 介 绍 它 的 优 缺 点 ， 学 习 下 它 如 何 安装 以 及 一 些 配 
置 和 运行 原理 。 


8.1.1 Spring Boot 简介 


Spring Boot 是 由 Pivotal 团队 提供 的 全 新 框架 ， 其 设计 目的 是 用 来 简化 新 Spring 应 用 的 初 
始 搭建 以 及 开发 过 程 。 该 框架 使 用 了 特定 的 方式 来 进行 配置 , 从 而 使 开发 人 员 不 再 需要 定义 样 
板 化 的 配置 。 通 过 这 种 方式 ，Boot 致力 于 在 蓬勃 发 展 的 快速 应 用 开发 领域 (rapid application 
development) 成 为 领导 者 。 

Spring Boot 有 以 下 特点 : 


(1) 能 够 快速 创建 基于 Spring 的 应 用 程序 。 (简化 配置 

(2) 能 够 直接 使 用 Java 的 main 方法 启动 内 嵌 的 Tomcat, Jetty 服务 器 运行 Spring Boot 
程序 ， 不 需要 部 署 war 包 文 件 。 

(3) 提供 约定 的 starter POM 来 简化 Maven ACH, ik Maven 配置 变 得 简单 。 

(4) 根据 项 目的 maven 依赖 配置 ，Spring Boot 自动 配置 Spring、SpringMVC 等 其 他 开源 
框架 。 

(5) 提供 程序 的 健康 检查 等 功能 (检查 内 部 的 运行 状态 等 )。 
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(6) 基本 可 以 完全 不 使 用 xml 配置 文件 ， 采 用 注解 配置 。 (或 者 默认 约定 的 配置 ， 代 码 
中 已经 实现 ) 


Spring Boot 可 以 支持 快速 地 开发 出 restful 风格 的 微服 务 架 构 ， 非 常 适合 做 微服 务 ， 单 一 
jar 包 部 署 和 管理 也 非常 方便 , 不 但 配置 精简 , 而 且 方便 将 Spring 生态 圈 和 其 他 工具 链 整 合 ( 比 
如 Redis、Email、Elasticsearch) o 


8.1.2 在线 安 装 


Eclipse 导入 Spring Boot 有 两 种 方式 : 一 种 是 在 线 安装 ， 一 种 是 离线 安装 。 单 击 Eclipse 
中 的 help 一 Eclipse Marketplace， 搜 索 sts， 如 图 8-1 所 示 ， 单 击 Installed 按钮 进行 在 线 安装 。 


{& Eclipse Marketplace a x 
Eclipse Marketplace 

Select solutions to install. Press Install Now to proceed with installation. 

Press the "more info" link to learn more about a solution. 

Search Recent Popular Favorites Installed |) Eclipse Newsletter: Boot Build Eclips... 

Find: [sts 5 [All Markets v| Al Categories v 


^ 


Spring Tools 3 Add-On (aka Spring Tool Suite 3) 3.9.5.RELEASE 


^ Spring Tools 3 The Spring Tools 3 contain the previous generation Spring 
| tooling for Eclipse, mostly focused on working with Spring apps configured using 
XML and... more info 


by Pivotal, EPL 


J2EE spring Spring IDE Cloud jee .. 
% 48 | Installs: 42.1K (26,645 last month) Installed 
v 
Marketplaces 


Era 


® <Back install Now > Finish Cancel 


图 8-1 
8.1.3 ”离线 安装 


离线 安装 时 ， 可 以 先 从 https://spring.io/tools3/sts/all 中 下 载 sts 插件 ， 这 里 下 载 的 是 
springsource-tool-suite-3.9.4. RELEASE-e4.7.3a-updatesite 这 个 版 本 ,然后 选择 help 一 Install New 
Software 一 Add 一 Archive〈 由 于 这 里 没 解压 ， 因 此 选 的 是 Archive) ， 选 择 要 安装 的 组 件 ， 单 
击 Next， 如 图 8-2 所 示 。 
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Er a 
Available Software 
Check the items that you wich to install. : 


h: STS - jartile/EJspringsource-toci-sute-3 4 RELEASE-e47.3a-updateste zipi/ add. Manage. 


四 四 四 四 四 四 让 


pring Tooling Language Servers for Edipse 


Solect Al | | Desolect Ab 


Contact all up 


2 < Back Nex > Finish Cancel 


8-2 
8.1.4 创建 Spring Boot Ji El 


安装 Spring Boot 插件 之 后 ， 在 Eclipse 中 创建 Project 时 就 会 增加 Spring Boot 选项 ， 如 图 
8-3 所 示 。 


@ New Project u x 


Select a wizard — 


Wizards: 
type filter text 


© JAXB ^ 
IPA 
£5 Maven 
E Plug-in Development 
D Spring 
v © Spring Boot 
(ij Import Spring Getting Started Content 
Gi Spring Starter Project 
© Web 


£5 Examples v 


< Back Next > Finish Cancel 


图 8-3 


安装 完 之 后 我 们 创建 一 个 简单 的 Web 工程， 了 解 一 下 Spring Boot 项 目 创建 的 过 程 。 首 先 
在 File 菜单 下 单 击 New 一 Project， 选 中 Spring Boot 下 的 Spring Starter Project， 如 图 8-4 所 示 。 
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> © JAXB ^ 
> IPA 
> © Maven 
> © Plug-in Development 
> © Spring 
v © Spring Boot 
(@ Import Spring Getting Started Content 
(Gj Spring Starter Project 
@ Web 
© Examples 


图 8-4 


然后 配置 项 目 名 称 、 版 本 等 信息 。 这 里 创建 了 一 个 HelloWorld 的 项 目 来 演示 Spring Boot 
的 简单 使 用 。 选 择 Spring Boot 的 版 本 (2.0.1 版 本 ) ， 并 勾 选 项 目 用 到 的 依赖 Web 模块 ， 单 击 
Finish， 如 图 8-5 所 示 。 


New Spring Starter Project 


Service URL — [htps//startspringio 


Name HelloWorld 


L Use default location 
Location C:\Users\admin\Desktop\SEA\MSE\HelloWorld 


Type: Maven E Packaging [Jar ~ 


Java Version: (B ~ Language: [Java 


Group com.example] 


Artifact HelloWorld 


Version 0.1-SNAPSHOT - 


Description ^ [Demo project for Spring Boot 


Package com.example demo 


Tk E 


图 8-5 


在 com.example.demo 包 下 新 建 ndexController 类 ,在 类 中 增加 一 个 Hello 方法 ,返回 “Hello 
World”， 如 果 @RestController 注解 不 理解 也 没关系 ， 后 续 会 有 介绍 。 


package com.example.demo; 


import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 


@RestController 


@RequestMapping ("/index") 
public class IndexController { 
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GRequestMapping ("/hello") 
public String Hello()( 
return "Hello World"; 
j 
} 


选中 项 目 ， 右 击 ， 依 次 选择 Run AS— Spring Boot App， 一 个 简单 的 Spring Boot 项 目 就 运 
行 成 功 了 ， 在 浏览 器 输入 url“http://localhost:8080/index/hello” 之 后 ， 结 果 如 图 8-6 所 示 。 


YESS ONSE er D localhost:2080 


Hello World 


图 8-6 


局 .和 Spring Boot 基本 配置 


本 节 先 了 解 一 下 Spring Boot 基础 配置 ， 主 要 包含 定制 Banner, Spring Boot 配置 文件 、 使 
用 xml 配置 三 部 分 。 


8.2.1 定制 Banner 


启动 Spring Boot 项 目 时， 会 在 控制 台 打 印 默认 的 banner， 如 果 想 炫 酷 一 些 ， 自 己 定 义 也 
是 支持 的 ， 如 图 8-7 所 示 。 


图 8-7 


首先 在 src/main/resource 下 新 建 banner.txt, 然后 打开 http://patorjk.com/software/taag, 输入 
要 显示 的 文字 ， 选 择 想 要 的 样式 ， 如 图 8-8 所 示 。 再 复制 到 banner.txt 中 ， 再 次 启动 时 就 会 发 
现 banner 已 变 ， 如 图 8-9 所 示 。 


CN 433 
上 


图 8-8 


169 


pring 快速 入 门 


图 8-9 
如 果 想 关闭 banner， 可 以 修改 main， 设 置 banner mode 为 OFF. 


public static void main(String[] args) { 
//SpringApplication.run(HelloWorldApplication.class, args); 
SpringApplication app=new SpringApplication 
(HelloWorldApplication.class) ; 
app .setBannerMode (Banner .Mode. OFF) ; 
app.run (args); 


} 
8.222 配置 文件 


Spring Boot 使 用 一 个 全 局 的 配置 文件 ， 配 置 文件 名 是 固定 的 ，application.properties 或 
application.yml， 可 以 用 来 修改 Spring Boot 自动 配置 的 默认 值 。 

这 里 在 application.properties 设置 服务 端的 端口 为 8081， 再 次 启动 项 目 时 ， 服 务 器 的 端口 
已 经 变 成 了 8081， 如 图 8-10 所 示 。 


server.port=8081 


c > oO 命 localhost: 


Hello World 


图 8-10 
8.2.8 使 用 xml 配置 


虽然 Spring Boot 不 提倡 使 用 xml 配 置 , 但 有 时 候 也 还 是 需要 用 的 。 这 里 我 们 在 sre/main/java 
下 创建 com.example.services 包 ， 在 包 下 创建 一 个 bean 对 象 HelloService， 由 于 Spring Boot 
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默认 扫描 的 是 HelloWorldApplication main 方法 对 应 的 包 以 及 子 包 ， 不 会 扫 到 
com.example.services 包 ， 我 们 在 IndexController 注入 一 个 该 服务 ， 然 后 启动 ， 发 现 会 报错 ， 找 
不 到 该 类 。 

定义 bean 对 象 HelloService: 


package com.example.services; 
public class HelloService { 


} 
配置 bean 对 象 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"» 
<bean id-"helloService" class="com.example.services.HelloService"> 
</bean> 
</beans> 


在 IndexController 注入 bean X1 $: 


package com.example.demo; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
import com.example.services.HelloService; 


@RestController 
@RequestMapping ("/index") 
public class IndexController { 


@Autowired 
HelloService helloService; 


GRequestMapping ("/hello") 


public String Hello() { 
return "Hello World"; 


运行 项 目 就 会 报 下 面 的 错误 ， 找 不 到 该 bean 对 象 ， 如 图 8-11 所 示 。 


Field helloService in com.example.demo.IndexController required a bean of 
type 'com.example.services.HelloService' that could not be found. 
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Description: 


Field helloService in com.example.demo.IndexController required a bean of type ‘com.example.services.HelloService’ that could not be found. 


The injection point has the following annotations: 
- Borg.springframework.beans.factory.annotation.Autowired(requiredetrue) 


Action: 


Consider defining a bean of type 'com.example.services.HelloService' in your configuration. 


图 8-11 


需要 在 main 方法 对 应 的 包 下 创建 配置 文件 引入 bean， 以 便 让 Spring Boot 能 扫描 到 。 配置 
ConfigClass 之 后 就 可 以 成 功 启 动 项 目 。 


package com.example.demo; 


import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.ImportResource; 


@Configuration 
@ImportResource (locations = {"application-bean.xml"}) 
public class ConfigClass { 


} 


5. Spring Boot 读 取 配置 


在 上 一 小 节 介绍 了 配置 文件 的 使 用 ， 设 置 server.port-8081 之 后 服务 端 启动 的 端口 就 变 成 
了 8081， 那 它 是 怎么 读 取 配置 信息 的 呢 ? 


8.8.0 读 取 核 心 配 置 文件 

核心 配置 文件 是 指 在 resources 根 目录 下 的 application.properties 或 application.yml 配置 文 
件 。 读 取 这 两 个 配置 文件 的 方法 有 以 下 两 种 ， 都 比较 简单 。 

1. 使 用 @Value 方式 〈 常 用 ) 


在 @Value 的 $ 人 中 包含 的 是 核心 配置 文件 中 的 键 名 。 在 IndexController 中 增加 Name 属性 ， 
并 使 用 @Value 为 其 赋值 。 在 hello0 中 同时 返回 Name 的 值 ， 如 图 8-12 所 示 。 


@Value ("${Test .Name}") 
private String Name; 


GRequestMapping ("/hello") 
public String Hello()( 

return "Hello World, "*Name; 
) 
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fa EO) Gey D localhost8081/index/hello 


Hello World.testName 


图 8-12 
2. 使 用 Environment 方式 


这 种 方式 是 依赖 注入 Evnironment 来 完成 的 ， 在 创建 的 成 员 变量 private Environment env 
上 加 上 @Autowired 注解 即 可 完成 依赖 注入 ， 然 后 使 用 env.getProperty(" 键 名 ") 即 可 读 取出 对 应 
的 值 。 结 果 如 图 8-13 所 示 。 


@Autowired 
Private Environment env; 


@RequestMapping ("/hello2") 
public String Hello2()( 
return "Hello World,"-*env.getProperty ("Test.Name"); 


) 


E => 从 


Hello World,testName 


A 8-13 
8.3.2 读 取 自 定义 配置 文件 
为 了 不 破坏 核心 文件 的 原生 态 , 但 又 需要 有 自 定 义 的 配置 信息 存在 , 一 般 情况 下 会 选择 自 
定义 配置 文件 来 放 这 些 自 定义 信息 , 这 里 在 resources 目录 下 创建 配置 文件 test.properties。Spring 
Boot 提供 了 类 型 安全 的 配置 方式 , 通过 @ConfigurationProperties 将 Properties 属性 和 一 个 Bean 
及 其 属性 关联 ， 从 而 实现 类 型 安全 的 配置 。 
(1) 在 src/main/resource 下 创建 一 个 test.properties 的 属性 文件 。 


person.Name=xiaoming 
person.Age=18 
(2) 创建 PersonSetting 类 ， 用 来 与 test 属性 文件 进行 关联 。 
在 com.example.demo 包 下 创建 PersonSetting 类 ， 用 来 与 test 属性 文件 进行 关联 。 


package com.example.demo; 
import org.springframework.boot.context.properties. 
ConfigurationProperties; 


import org.springframework.context.annotation.PropertySource; 
import org.springframework.stereotype.Component; 
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GComponent 
GPropertySource (value = "classpath:/test.properties") 
@ConfigurationProperties (prefix-"person") 
public class PersonSetting ( 
private String name; 
private int age; 
public String getName() ( 
return name; 
H 
public void setName(String name) ( 
this.name - name; 
) 
public int getAge() ( 
return age; 
} 
public void setAge (int age) { 
this.age = age; 


} 


(3) 在 IndexController 注入 PersonSetting. 


@Autowired 

PersonSetting personSetting; 
GRequestMapping ("/hello3") 
public String Hello3()( 


return "Hello World,Name:"+personSetting.getName()+",Age:"+ 
personSetting.getAge(); 


) 


(4) 启动 , 在 浏览 器 中 输入 “http://localhost:8081/index/hello3”, 可 以 显示 出 PersonSetting 
的 属性 值 ， 如 图 8-14 所 示 。 


FTEs D lecalhosto 


Hello World,Name:xiaoming.Age:18 


图 8-14 


Profile 配置 


在 开发 中 可 能 会 部 署 多 个 环境 ， 每 个 环境 部 署 的 配置 可 能 不 一 样 。 我 们 可 以 使 用 
application.properties 进行 多 个 环境 的 配置 ， 通 过 application-{profile}.properties 来 控制 加 载 哪 
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个 环境 的 配置 ， 将 与 环境 无 关 的 属性 放置 到 application.properties 文件 里 面 ， 通 过 
spring.profiles.active=profiles 的 值 ， 加 载 不 同 环境 的 配置 ， 如 果 不 指定 ， 就 默认 加 载 
application.properties 的 配置 ， 不 会 加 载 带 有 profile 的 配置 。 

我 们 可 以 创建 application-dev.properties 开发 和 application-prod.properties 生产 属性 文件 ， 
分 别 指定 不 同 的 port。 在 application-dev.properties 文件 中 指定 端口 8082， 在 application-prod. 
properties 文件 中 指定 端口 8083 。 

在 application.properties 中 设置 环境 ， 如 果 设 置 的 是 dev 环境 , 那么 启动 的 端口 就 是 8082 。 
如 果 设 置 的 是 prod 环境 , 那么 启动 的 端口 就 是 8083。 这 里 设置 的 是 spring.profiles.active=prod， 
所 以 项 目 启动 时 端口 号 为 8083。 结 果 如 图 8-15 所 示 。 

server.port=8081 


Test .Name=testName 
spring.profiles.active=prod 


€ aN O Q D localhost: 


Hello World. Name:xiaoming,Age:18 


图 8-15 


8.5.4 简 述 


日 志 在 项 目 中 应 该 算是 最 重要 的 部 分 之 一 , 尤其 是 上 线 之 后 , 好 的 日 志 配 置 能 够 将 其 优势 
发 挥 到 极致 ， 大 大 降低 后 期 的 维护 成 本 ,好 的 日 志 配置 能 够 让 程序 员 一 眼看 出 项 目的 问题 ， 继 
而 加 以 改善 。 这 章 我 们 就 来 学 习 一 下 Spring Boot 中 的 日 志 配 置 。 

Spring Boot 内 部 代码 使 用 的 是 commons-logging 来 记录 日 志 的 , 但 是 底层 日 志 实 现 框 架 是 
可 以 随意 蔡 换 的 。Spring Boot 为 Java Util Logging. Log4J2 和 Logback 日 志 框 架 提 供 了 默认 配 
置 ， 并 且 如 果 使 用 了 Starters， 那 么 默认 使 用 Logback， 如 图 8-16 所 示 。 

26. Logging 


Spring Boot uses Commons Logging for all internal logging but leaves the underlying log implementation open. Default configurations are provided for Java Util Logging. 
Log412, and Logback. In each case, loggers are pre-configured to use console output with optional file output also available. 


By default, if you use the "Starters", Logback is used for logging. Appropriate Logback routing is also included to ensure that dependent libraries that use Java Util 
Logging, Commons Logging, Log4J, or SLF4J all work correctly. 


图 8-16 


那么 什么 是 Starters WE? 其 实 只 要 你 的 pom 文件 中 使 用 了 spring-boot-starter 就 代表 你 
用 了 Spring Boot 的 Starters. Aly Starters〈 启 动 器 ) 是 Spring Boot 最 核心 的 部 件 之 一 ， 没 有 
了 启动 器 ，Spring Boot 就 几乎 废 掉 了 。 
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8.5.2 Logback 的 使 用 


Spring Boot 招 人 喜欢 的 一 大 特点 就 是 配置 方便 ， 配 置 日 志 的 相关 参数 也 只 需要 写 在 
application.properties 中 就 可 以 了 。 当 然 , 这 仅仅 是 基本 的 配置 ， 如 果 需 要 高 级 的 配置 ， 还 是 需 
要 添加 依赖 所 选择 日 志 系 统 的 配置 文件 。Spring Boot 的 Logging 配置 的 级 别 有 7 个 : TRACE、 
DEBUG、INFO、WARN、ERROR、FATAL、OFF， 如 图 8-17 所 示 。 

26.4 Log Levels 


laii tne supported logging systems can have the logger levels set in the Spring Environment (for example, in application. properties ) by using 
logging. 1evel.<logger-name>=<level> where level is one of TRACE, DEBUG, INFO, WARN, ERROR, FATAL, or OFF The root logger can be configured by 
using logging. level.root 


[The following example shows potential logging settings in application. properties 


logging.level.root-WARN 
logging.lovel.org.springframework web-DEBUG 
logging. level.org.hibernate=ERROR 


图 8-17 


在 进行 了 这 样 的 配置 后 ， 就 可 以 在 控制 台 打 印 Log 信息 了 。 但 在 生产 环境 中 ， 日 志 往往 
要 以 文件 形式 存放 到 本 地 , 那么 Spring Boot 的 默认 配置 文件 能 够 实现 吗 ? 答案 是 可 以 的 , 我 
们 继续 看 官方 文档 ， 如 图 8-18 所 示 。 
[63 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


By default, Spring Boot logs only to the console and does not write log fies. If you want to write log files in addition to the console output, you need to set a 
logging.file or logging.path property (for example, in your application. properties ) 


The following table shows how the logging.* properties can be used together: 


Table 26.1. Logging properties 


logging. file  logging.path Example Description 


(none) (none) Console only logging. 
Specific file. (none) my.log ‘Writes to the specified log file. Names can be an exact location or relative to the current directory. 
(none) Specific directory /var/log Wntes spring.log to the specified directory. Names can be an exact location or relative to the current 
directory. 
图 8-18 


在 默认 情况 下 ，Spring Boot 是 仅仅 在 控制 台 打 印 log 信息 的 ， 如 果 我 们 需要 将 log 信息 记 
录 到 文件 ， 那 么 就 需要 在 application.properties 中 配置 logging.file 或 者 logging.path。 配 置 
logging. file 的 话 是 可 以 定位 到 自 定 义 的 文件 的 ， 使 用 logging.path 的 话 ， 日 志文 件 将 使 用 
spring.log 来 命名 。 而 且 日 志文 件 会 在 10Mb 大 小 的 时 候 被 截断 ， 产 生 新 的 日 志文 件 ， 默 认 级 
别 为 : ERROR, WARN, INFO. 如果 要 自 定义 输出 格式 怎么 办 呢 ? 其 实在 application.properties 
也 是 可 以 办 到 的 。 可 以 在 application.properties 中 使 用 下 面 几 个 配置 ， 不 过 部 分 只 对 默认 的 日 
志 系 统 Logback 起 作用 ， 如 图 8-19 所 示 。 
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To help with the customization, some other properties are transferred from the Spring Environment to System properties, as described in the following table: 


Spring Environment System Property Comments 


logging.exception-conversion-word ^ LOG EXCEPTION CONVERSION WORD The conversion word used when logging exceptions. 


logging.file 106 FILE If defined, itis used in the default log configuration. 

logging.file.max-size LOG FILE MAX SIZE [Maximum log file size (if LOG FILE enabled). (Only supported with the default 
lLogback setup.) 

logging. file.max-history LOG FILE MAX HISTORY Maximum number of archive log files to keep (if LOG. FILE enabled). (Only 
supported with the default Logback setup.) 

logging.path LOG PATH If defined, it is used in the default log configuration. 

logging. pattern.console CONSOLE. LOG PATTERN The log pattern to use on the console (stdout). (Only supported with the default 
Logback setup.) 

logging.pattern.dateformat LOG DATEFORMAT PATTERN Appender patter for log date format. (Only supported with the default Logback 
setup.) 

logging. pattern. file FILE LOG PATTERN The log pattern to use in a file (if LOG FILE is enabled) (Only supported with 
the default Logback setup.) 

logging.pattern.level LOG LEVEL PATTERN The format to use when rendering the log level (default Sp ). (Only supported 
with the default Logback setup.) 

PID PID The current process ID (discovered if possible and when not already defined 


as an OS environment variable). 


图 8-19 


在 application.properties 中 将 环境 切 为 开发 模式 ， 然 后 设置 了 日 志 的 级 别 、 日 志文 件 存放 
位 置 、 日 志 在 控制 台 输 出 的 格式 、 日 志 在 日 志文 件 输出 的 格式 。 


spring.profiles.active=dev 

logging. level. root=INFO 

logging. level.org.springframework.web=DEBUG 

logging. file=E:/log/log.log 

logging.pattern.console=%d{ yyyy/MM/dd-HH:mm:ss} [%thread] %-5level 
$logger- $msg$n 

logging.pattern.file-$d(yyyy/MM/dd-HH:mm) [%thread] %-5level %logger- 
smsg%n 


再 次 启动 项 目 ， 则 会 在 日 志文 件 路 径 EMog 下 找到 log.log 的 日 志 ， 如 图 8-20 所 示 。 
| 此 电脑 > S (E) > log 


名 称 v 修改 日 期 类 型 大 小 
El log.log 2018/11/17 14:01 ”文本 文档 12 KB 


8-20 


application.properties 中 的 配置 有 的 时 候 不 能 满足 我 们 的 要 求 ， 或 者 我 们 要 使 用 其 他 的 集 
成 进 Spring Boot 的 日 志 系统 ， 该 怎么 办 呢 ? 官方 文档 又 给 了 我 们 答案 ， 如 图 8-21 所 示 。 
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26.6 Custom Log Configuration 


The various logging systems can be activated by including the appropriate libraries on the classpath and can be further customized by providing a suitable configuration 
file in the root of the classpath or in a location specified by the following Spring (Environment property: logging.config. 


You can force Spring Boot to use a particular logging system by using the org.springframework. boot. logging. LoggingSystem system property. The value should 
be the fully qualified class name of a LoggingSystem implementation. You can also disable Spring Boots logging configuration entirely by using a value of none 


@ _ Since logging is initialized before the (ApplicationContext| is created, itis not possible to control logging from (@PropertySources) in Spring 
(Configuration files. The only way to change the logging system or disable it entirely is via System properties. 


Depending on your logging system, the following files are loaded: 


Logging System Customization 
Logback logback-spring.xml, logback-spring. groovy. logback.xml, or logback.groovy 
Log4j2 1og4j2-spring.xml or log4j2.xml 

JDK (Java Util Logging) logging. properties 


@ | When possible, we recommend that you use the | -Spring) variants for your logging configuration (for example, [Logback-spring. xml) rather than 
‘logback.xm1)). If you use standard configuration locations, Spring cannot completely control log initialization. 


There are known classloading issues with Java Util Logging that cause problems when running from an ‘executable jar. We recommend that you avoid it 
when running from an ‘executable jar if at all possible. 


图 8-21 


(1) 通过 将 适当 的 库 添 加 到 classpath， 可 以 激活 各 种 日 志 系统 。 然 后 在 classpath 的 根 目 
录 (root) 或 通过 Spring Environment Capplication.properties) 的 logging.config 属性 指定 的 位 
置 提供 一 个 合适 的 配置 文件 来 达到 进一步 的 定制 。 (注意 ， 由 于 日 志 是 在 ApplicationContext 
被 创建 之 前 初始 化 的 , 因此 不 可 能 在 Spring 的 @Configuration 文件 中 通过 @PropertySources 控 
制 日 志 。 系 统 属性 和 平常 的 Spring Boot 外 部 配置 文件 能 正常 工作 。) 

(2) 如 果 我 们 使 用 指定 日 志 系统 的 配置 文件 ，application.properties 中 相关 的 日 志 配置 是 
可 以 不 要 的 。 

GO 支持 的 三 种 日 志 系统 (Logback，Log4j2 (Log4j 也 是 支持 的 ) , JDKLogging) 所 识 
别 的 配置 文件 名 。 


使 用 Logback 的 指定 配置 文件 实现 更 高 级 的 日 志 配置 ， 启 用 的 方式 很 简单 ， 在 classpath 
的 resources 下 新 建 logback.xml 文件 即 可 。 


<?xml version="1.0" encoding-"UTF-8"?» 
<configuration> 
<!-- 控制 台 打 印 日 志 的 相关 配置 --> 
<appender name-"STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
<!-- 日 志 格式 --> 
<encoder> 
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%level] - %m%n</pattern> 
</encoder> 
<!-- 日 志 级 别 过 滤器 --> 
<filter class="ch.gos.logback.classic.filter.LevelFilter"> 


<!-- 过 滤 的 级 别 --> 
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<leve1>DEBUG</level> 
<!-- 匹配 时 的 操作 : 接收 (记录 ) --> 
<onMatch>ACCEPT</onMatch> 
<!-- 不 匹配 时 的 操作 : 拒绝 (不 记录 ) --> 
<onMismatch>DENY</onMismatch> 
</filter> 
</appender> 


<!-- 文件 保存 日 志 的 相关 配置 --> 
<appender name="ERROR-OUT" class-"ch.qos.logback.core.rolling. 
RollingFileAppender"> 
<!-- 保存 日 志文 件 的 路 径 --> 
<file>E:/log/log.log</file> 


<!-- 日 志 格式 --> 
<encoder> 

Xpattern»$d(yyyy-MM-dd HH:mm:ss} [%class:%line] - %m%n</pattern> 
</encoder> 


<!-- 日 志 级 别 过 滤器 --> 
<filter class="ch.gos.logback.classic.filter.LevelFilter"> 
<!-- 过 滤 的 级 别 --> 
<leve1l>DEBUG</level> 
<!-- 匹配 时 的 操作 : 接收 (记录 ) --> 
<onMatch>ACCEPT</onMatch> 
«t-- 不 匹配 时 的 操作 : 拒绝 (不 记录 ) --> 
<onMismatch>DENY</onMismatch> 
</filter> 
«i-- 循环 政策 ， 基 于 时 间 创建 日 志文 件 --> 
<rollingPolicy class-"ch.qos.logback.core.rolling. 
TimeBasedRollingPolicy"> 
<!-- 日 志文 件 名 格式 --> 
<fileNamePattern>error.%d{yyyy-MM-dd} .log</fileNamePattern> 
<!-- 最 大 保存 时 间 : 30 天 --> 
<maxHistory>30</maxHistory> 
</rollingPolicy> 
</appender> 


<!-- 基于 dubug MH AR: 具体 控制 台 或 者 文件 对 日 志 级 别 的 处 理 还 要 看 所 在 appender 配置 
的 filter， 如 果 没 有 配置 filter， 则 使 用 root 配置 --> 
<root level="debug"> 
<appender-ref ref="STDOUT" /> 
<appender-ref ref="ERROR-OUT" /> 
</root> 
</configuration> 


8.5.3 Log4j2 的 使 用 


在 创建 Spring Boot 工程 时 , 我 们 引入 了 spring-boot-starter, 其 中 包含 了 spring-boot-starter- 
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logging, 该 依赖 内 容 就 是 Spring Boot 默认 的 日 志 框架 Logback, 所 以 我 们 在 引入 Log4j2 之 前 ， 
需要 先 排除 该 包 的 依赖 再 引入 Log4j2 的 依赖 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 
<exclusion> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-logging</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-log4j2</artifactId> 
</dependency> 


和 Logback 一 样 ,我 们 可 以 使 用 application.properties， 如 果 需 要 更 高 级 的 配置 选择 ， 必 须 
要 添加 Log4j2 的 配置 文件 了 。 我 们 在 classpath 的 resources 下 新 建 log4j2.xml 文件 : 


<?xml version="1.0" encoding-"UTF-8"?» 
<configuration> 
<appenders> 
«Console name-"Console" target="SYSTEM_OUT"> 
<ThresholdFilter level-"trace" onMatch-"ACCEPT" 
onMismatch="DENY" /> 
<PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level $class(36) $L 
$M - $msg$xEx$n" /> 
«/Console» 
«File name-"log" fileName-"E:/log/test.log" append="false"> 
<PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level $class(36] $L 
$M - $&msg$xEx$n" /> 
</File> 
<RollingFile name-"RollingFile" fileName-"E:/log/spring.log" 
filePattern-"log/$$[date:yyyy-MM) /app- $d(MM-dd-yyyy] -$i.log"» 
<PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} $-51level 
$class(36)] $L $M - $msg$xEx$n" /> 
<SizeBasedTriggeringPolicy size-"50MB" /> 
</RollingFile> 
</appenders> 
<loggers> 
<root level="DEBUG"> 
<appender-ref ref="RollingFile" /> 
<appender-ref ref-"Console" /> 
</root> 
</loggers> 
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</configuration> 
重新 启动 项 目 ， 在 EMog 文件 夹 下 就 能 看 到 3 个 日 志文 件 ， 如 图 8-22 所 示 。 
> X (E) » log 
ae 2 BEBE ET A 
E leglog 2018/11/17 15:04 文本 文档 100 KB 
E spring.log 2018/11/17 15:44 文本 文档 0 KB 
E testlog 2018/11/17 15:44 ”文本 文档 0 KB 


图 8-22 


2.6 运行 原理 
8.61 习惯 优 于 配置 


Spring Boot 出 现 之 后 ， 得 益 于 “习惯 优 于 配置 ”这 个 理念 ， 再 也 没有 烦琐 的 配置 、 难 以 
集成 的 内 容 〈 大 多 数 流行 第 三 方 技术 都 被 集成 在 内 ) 。 那么 背后 实现 的 核心 原理 到 底 是 什么 
WE? Spring Boot 关于 自动 配置 的 源码 在 spring-boot-autoconfigure-x.x.x.x.jar 中 ， 主 要 包含 了 如 
图 8-23 所 示 的 配置 。 


spnng-boot-autoconfigure-2.1.0, Jar - D:\Maven\re 


> 88 org.springframework.boot.autoconfigure 

> 8B org.springframework.boot.autoconfigure.admin 

> 8&8 org.springframework.boot.autoconfigure.amqp 

> 88 org.springframework.boot.autoconfigure.aop 

> 88 org.springframework.boot.autoconfigure.batch 

> 88 org.springframework.boot.autoconfigure.cache 

> 88 org.springframework.boot.autoconfigure.cassandra 

> 88 org.springframework.boot.autoconfigure.cloud 

> 88 org.springframework.boot.autoconfigure.condition 

> 88 org.springframework.boot.autoconfigure.context 

> {Œ org.springframework.boot.autoconfigure.couchbase 

> 88 org.springframework.boot.autoconfigure.dao 

> 8B org.springframework.boot.autoconfigure.data 

> 88 org.springframework.boot.autoconfigure.data.cassandr; 
> $ org.springframework.boot.autoconfigure.data.couchbas, 
> 8B org.springframework.boot.autoconfigure.data.elasticsea 
> 88 org.springframework.boot.autoconfigure.data.jdbc 

> 88 org.springframework.boot.autoconfigure.data.jpa 


图 8-23 


我 们 可 以 在 这 里 看 见 所 有 Spring Boot 为 我 们 做 的 自动 配置 。 通 过 在 application.properties 
中 设置 属性 “debug=true”, 可 以 通过 控制 台 的 输出 观察 自动 配置 启动 的 情况 , 如 图 8-24 所 示 。 
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CodecsAutoConfiguration matched: 
- @ConditionalonClass found required class 'org.springframework.http.codec.CodecConfigurer' (OnClassCondition) 


CodecsAutoConfiguration.JacksonCodecConfiguration matched: 
- @ConditionalonClass found required class 'com.fasterxml.jackson.databind.ObjectMapper' (OnClassCondition) 


CodecsAutoConfiguration.JacksonCodecConfigurationsjacksonCodecCustomizer matched: 


- @ConditionalonBean (types: com.fasterxml.jackson.databind.ObjectMapper; SearchStrategy: all) found bean 'jacksonObjectMappe 


DispatcherServletAutoConfiguration matched: 
- GConditionalonClass found required class 'org.springframework.web.servlet.DispatcherServlet' (OnClassCondition) 
- found ConfigurableWebEnvironment (OnWebApplicationCondition) 
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在 第 一 次 使 用 Spring Boot 的 时 候 , 大 家 都 会 惊讶 于 @SpringBootApplication 这 个 注解 ， 有 
了 它 马 上 就 能 够 让 整个 应 用 跑 起 来 。 实 际 上 它 只 是 一 个 组 合 注解 ， 包 含 @Configuration、 


@EnableAutoConfiguration, @ComponentScan 这 三 个 注解 。 


@Target (ElementType. TYPE) 
@Retention (RetentionPolicy. RUNTIME) 
@Documented 

@Inherited 
@SpringBootConfiguration 
@EnableAutoConfiguration 
@ComponentScan (excludeFilters = { 


@Filter (type = FilterType.CUSTOM, classes = TypeExcludeFilter. class), 


@Filter(type = FilterType.CUSTOM, classes = 
AutoConfigurationExcludeFilter.class) }) 
public @interface SpringBootApplication { 


@AliasFor (annotation = EnableAutoConfiguration.class) 
Class<?>[] exclude() default {}; 


@AliasFor (annotation = EnableAutoConfiguration.class) 
String[] excludeName() default {}; 


@AliasFor (annotation = ComponentScan.class, attribute = "basePackages") 


String[] scanBasePackages() default {}; 


@AliasFor (annotation = ComponentScan.class, attribute = 
"basePackageClasses" 
Class<?>[] scanBasePackageClasses() default {}; 


) 


它 的 核心 功能 是 由 @EnableAutoConfiguration 这 个 注解 提供 的 ， 我 们 来 看 看 


@EnableAutoConfiguration 的 源 代码 : 


QTarget (ElementType. TYPE) 
@Retention (RetentionPolicy. RUNTIME) 
@Documented 


182 


#88 Spring Boot fc 


@Inherited 
@AutoConfigurationPackage 

@Import (AutoConfigurationImportSelector.class) 
public @interface EnableAutoConfiguration { 


String ENABLED OVERRIDE PROPERTY = 
"spring.boot.enableautoconfiguration"; 


Class<?>[] exclude() default {}; 


String[] excludeName() default {}; 


} 
这 里 的 关键 功能 是 @Import 注解 导入 的 配置 功能 EnableAutoConfigurationImportSelector 
使 用 SpringFactoriesLoader.loadFactoryNames 方法 来 扫描 具有 META-INF/spring.factories 文件 
的 jar 4, spring-boot-autoconfigure-x.x.x.x jar 里 就 有 一 个 spring.factories 文件 ， 这 个 文件 中 声 


明了 有 哪些 要 自动 配置 。 
下 面 我 们 来 分 析 一 下 spring boot autoconfigure 里 面 的 JdbcTemplateAutoConfiguration， 应 


该 就 会 明白 这 套 自动 配置 机 制 到 底 是 怎么 一 回 事 了 : 


@Configuration 
@ConditionalOnClass({ DataSource.class, JdbcTemplate.class }) 


@ConditionalOnSingleCandidate (DataSource.class) 
@AutoConfigureAfter (DataSourceAutoConfiguration.class) 
@EnableConfigurationProperties (JdbcProperties.class) 
Public class JdbcTemplateAutoConfiguration { 


@Configuration 
static class JdbcTemplateConfiguration { 


Private final DataSource dataSource; 
Private final JdbcProperties properties; 
JdbcTemplateConfiguration (DataSource dataSource, JdbcProperties 
properties) { 
this.dataSource = dataSource; 
this.properties = properties; 
} 


@Bean 
@Primary 
@ConditionalOnMissingBean (JdbcOperations.class) 


public JdbcTemplate jdbcTemplate() { 
JdbcTemplate jdbcTemplate = new JdbcTemplate (this.dataSource) ; 


JdbcProperties.Template template = 


this.properties.getTemplate(); 
jdbcTemplate.setFetchSize (template.getFetchSize()); 


jdbcTemplate.setMaxRows (template.getMaxRows () ); 
if (template.getQueryTimeout() !- null) ( 
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jdbcTemplate 
.setQueryTimeout((int) template.getQueryTimeout(). 
getSeconds ()); 


H 
return jdbcTemplate; 


H 


GConfiguration 
@Import (JdbcTemplateConfiguration.class) 
static class NamedParameterJdbcTemplateConfiguration ( 


GBean 
GPrimary 
@ConditionalOnSingleCandidate (JdbcTemplate.class) 
@ConditionalOnMissingBean (NamedParameterJdbcOperations.class) 
public NamedParameterJdbcTemplate namedParameterJdbcTemplate ( 
JdbcTemplate jdbcTemplate) { 
return new NamedParameterJdbcTemplate (jdbcTemplate) ; 


} 
首先 这 被 @Configuration 注解 了 ， 是 一 个 配置 类 ， 当 满足 以 下 条 件 时 这 个 bean 被 装配 : 
(1) DataSource, DataSource 在 类 路 径 下 。 
(2)DataSource 指定 的 类 在 BeanFactory 中 只 有 一 个 候选 的 bean, 或 者 有 多 个 候选 的 bean， 
但 是 其 中 一 个 指定 了 primary. 
(3) 在 指定 的 配置 类 DataSourceAutoConfiguration 初始 化 后 再 加 载 。 
我 们 可 以 看 一 下 通过 @EnableConfigurationProperties(JdbcProperties.class) 自 动 注入 的 属性 
(这 是 习惯 优 于 配置 的 最 终 落 地 点 ) : 


GConfigurationProperties (prefix = "spring.jdbc") 
public class JdbcProperties { 


private final Template template = new Template(); 


public Template getTemplate() { 
return this.template; 
} 


Public static class Template { 
Private int fetchSize = -1; 
Private int maxRows = -1; 


@DurationUnit (ChronoUnit.SECONDS) 
private Duration queryTimeout; 
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public int getFetchSize() { 
return this. fetchSize; 
) 


public void setFetchSize(int fetchSize) { 
this.fetchSize - fetchSize; 
} 


Public int getMaxRows() { 
return this.maxRows; 
} 


public void setMaxRows (int maxRows) { 
this.maxRows = maxRows; 


j 


public Duration getQueryTimeout() ( 
return this.queryTimeout; 
) 


public void setQueryTimeout(Duration queryTimeout) { 
this.queryTimeout - queryTimeout; 


) 


) 


在 我 们 什么 都 不 干 的 情况 下 ， 只 需要 引入 数据 库 相 关 依 赖 ， 用 JdbeTemplate 访问 数据 库 
即 可 。 同 时 我 们 通过 在 application.properties 中 修改 spring.jdbc 相关 的 参数 就 能 够 修改 连接 配 
置 。 利 用 这 个 规则 ， 我 们 也 可 以 轻松 地 把 目前 Spring Boot 还 未 集成 的 、 我 们 自己 要 使 用 的 第 
三 方 技术 自动 集成 起 来 。 


8.7 wä 


本 节 主 要 学 习 Spring Boot 的 基础 知识 , 介绍 了 Spring Boot 插件 的 安装 、 基 本 配置 、 Profile 
配置 、 日 志 配 置 以 及 运行 原理 ， 为 后 续 Spring Boot 的 应 用 打下 基础 。 


185 


第 9 章 
«Spring Boot 的 应用 > 


上 一 章 学 习 了 Spring Boot 的 环境 安装 、 基 本 配置 等 内 容 ， 不 但 配置 精简 ， 而 且 方便 将 Spring 
生态 圈 和 其 他 工具 链 整合 ， 本 章 将 了 解 一 下 Spring Boot 的 具体 应 用 。 


本 章 主要 涉及 的 知识 点 : 


© Spring Boot 集成 Web: 集成 Thymeleaf、JSP。 
* Spring Boot 集成 Data: 集成 MyBatis、Redis、RabbitMQ 。 
© Spring Boot 集成 其 他 工具 : 集成 Druid、 打 包 测 试 部 署 、 定 时 任务 、 邮 件 发 送 。 


Spring Boot 之 Web 


Web 开发 都 会 涉及 前 端 页 面 展 示 ， 在 以 往 的 Spring MVC 框架 中 一 般 使 用 ISP 来 显示 页 
面 ， 那 Spring Boot 框架 中 又 是 用 什么 显示 Web We? 
9.1.1 Spring Boot 集成 Thymeleaf 

Spring Boot 提供 了 大 量 的 模板 引擎 ， 包 含 了 FreeMarker、Groovy、Thymeleaf、Velocity 
和 Mustache. Spring Boot 中 推荐 使 用 Thymeleaf 作为 模板 引擎 , 因为 Thymeleaf 提供 了 完美 的 
Spring MVC 的 支持 。Thymeleaf 是 一 个 Java 类 库 ， 它 是 一 个 xml/xhtml/html5 的 模板 引擎 ， 可 
以 作为 MVC 的 Web 应 用 的 View 层 。Thymeleaf 还 提供 了 额外 的 模块 与 Spring MVC 集成 ， 
所 以 我 们 可 以 使 用 Thymeleaf 完全 替代 JSP。 我 们 来 看 一 下 Thymeleaf 的 简单 使 用 。 

1. Thymeleaf 配置 


Thymeleaf 有 哪些 属性 可 以 配置 呢 ? 我 们 可 以 在 org.springframework.boot.autoconfigure. 
thymeleaf 下 的 ThymeleafProperties.class， 如 图 9-1 所 示 。 


v §B org.springframework.boot.autoconfigure.thymeleaf 


ti) ThymeleafAutoConfiguration.class 
ti ThymeleafProperties.class 
t ThymeleafTemplateAvailabilityProvider.class 


- "m " 


图 9-1 
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由 于 Spring Boot 约定 大 于 配置 ， 因 此 在 ThymeleafProperties.class 中 也 都 有 默认 值 ， 如 果 
我 们 想 改变 默认 值 ， 可 以 在 application.properties 设置 ， 属 性 的 前 级 为 spring.thymeleaf。 这 里 
用 的 都 是 它 的 默认 值 。 默 认 路 径 在 templates 下 ， 文 件 是 html 文件 ， 如 图 9-2 所 示 。 


@onfigurationProperties(prefix = "spring.thymeleaf") 
public class ThymeleafProperties { 


b private static final Charset DEFAULT ENCODING - StandardCharsets.UTF 8; 
n public static final String DEFAULT PREFIX = "classpath:/templates/"; 
3 public static final String DEFAULT SUFFIX = ".html"; 

- 

p * Whether to check that the template exists before rendering it. 

7 

e private boolean checkTemplate = true; 

e 

" * Whether to check that the templates location exists 

2 i 

5 private boolean checkTemplateLocation = true; 

| 

|: * Prefix that gets prepended to view names when building a URL 

7 “ 

g private String prefix = DEFAULT_PREFIX; 


* Suffix that gets appended to view names when building a URL 


private String suffix = DEFAULT_SUFFIX; 


* Template mode to be applied to templates. See also Thymeleaf's TemplateMode enum 


2. 项 目 引 入 Thymeleaf 


这 里 还 是 在 HelloWorld 的 例子 基础 上 进行 修改 , 需要 在 pom.xml 中 引入 Thymeleaf。 注意 
一 下 , 由 于 用 的 是 spring5, 如 果 引 入 的 Thymeleaf 版 本 不 正确 就 可 能 会 报错 , 而 且 不 同 的 spring 
引入 Thymeleaf 的 artifactld 也 不 一 样 。 


<dependency> 
<groupId>org.thymeleaf</groupId> 
<artifactId>thymeleaf-spring5</artifactId> 
<version>3.0.9.RELEASE</version> 
</dependency> 


3. 测试 
这 里 创建 一 个 User 类 ， 并 增加 getUsers() 方 法 来 返回 user 列表 。 


package com.example.demo; 


import java.util.ArrayList; 
import java.util.List; 


public class User ( 


private String name; 
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private int age; 


public int getAge() { 
return age; 

} 

public void setAge(int age) { 
this.age = age; 

H 

public String getName() ( 
return name; 

) 

public void setName(String name) ( 
this.name - name; 


public User(String name, int age) ( 
super () 
this.name = name; 
this.age = age; 


public static List<User>getUsers () 
if 


List<User> users=new ArrayList<User>(); 
for(int i=0;i<5;i++) 
{ 
User user=new User ("小 明 "+i,25+i); 
users .add (user); 


} 
return users; 


} 
新 建 HelloWorldController， 用 hello 方法 将 user 列表 加 入 model 的 属性 中 。 


package com.example.demo; 


import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 


@Controller 
@RequestMapping ("/helloworld") 
public class HelloWorldController { 
GRequestMapping (value = "/hello4",method = RequestMethod. GET) 
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public String hello(Model model) { 
model.addAttribute("users", User.getUsers()); 
return "hello"; 


H 


然后 在 classpath 路 径 下 的 templates 目录 下 新 建 hello.html 文件 。 这 里 要 注意 , 需要 在 html 
中 加 入 下 面 一 行 代码 : «html xmins:th="http://www.thymeleaf.org"> 。 


<!DOCTYPE HTML> 
<html xmlns:th-"http://www.thymeleaf.org"» 
<head> 
<title>hello</title> 
<meta http-equiv-"Content-Type" content-"text/html; charset-UTF-8" /> 
</head> 
<body> 
<table> 
<thead> 
<tr> 
<th> 序 号 </th> 
<th> 姓 名 </th> 
<th> 年 龄 </th> 
</tr> 
</thead> 
<tbody> 
<tr th:each="user,userState : ${users}"> 
«td th:text="${userState.index}"></td> 
«td th:text="${user.name} "></td> 
«td th:text="${user.age}"></td> 
</tr> 
</tbody> 
</table> 
</body> 
</html> 


在 hello.html 中 使 用 th:each 标签 来 迭代 循环 ， 语 法 : th:each="obj,iterStat:$ (objList]". i 
代 对 象 可 以 是 java.utilL.List、java.utiLMap、 数 组 等 。 这 里 只 列举 一 下 th:each 标签 的 使 用 ， 关 
于 Thymeleaf 的 使 用 ， 可 以 参考 它 的 官方 文档 ， 这 里 不 详细 介绍 。 

iterStat 称 作 状态 变量 ， 属 性 有 : 


* Index: 当前 和 迭代 对 象 的 index (A 0 开始 计算 ) 。 

© Count: 当前 迭代 对 象 的 index (从 1 开始 计算 ) o 

© Size: 被 迭代 对 象 的 大 小 。 

* Current: 当前 和 迭代 变量 。 

e even/odd: 布尔 值 ， 当 前 循环 是 否 是 偶数 /奇数 《从 0 开始 计算 ) 。 
* First: 布尔 值 ， 当 前 循环 是 否 是 第 一 个 。 
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° Last: 布尔 值 ， 当 前 循环 是 否 是 最 后 一 个 。 


最 后 启动 项 目 ， 在 浏览 器 输入 URL “http://localhost:8081/helloworld/hello4”， 之 后 就 会 在 
浏览 器 输出 user 列表 内 容 ， 如 图 9-3 所 示 。 


3502 c) localhost808 
序号 姓名 Fi 

0 ”小 明 025 

1 ”小 明 126 

2 ”小明 227 

3 ”小 肯 328 

4 “小明 429 

9-3 


9.1.2 Spring Boot 集成 JSP 


虽然 Spring Boot 推荐 使 用 Thymeleaf 作为 模板 引擎 ， 也 是 支持 使 用 JSP 的， 一些 旧 项 目 
在 转 Spring Boot 时 也 会 方便 一 些 ， 本 小 节 就 来 学 习 一 下 Spring Boot 集成 JSP 页 面 。 

这 里 还 是 在 HelloWorld 项 目 基础 上 进行 修改 ， 这 次 是 集成 JSP， 所 以 要 先 引入 ISP 的 依 
Hi EHE Thymeleaf 的 依赖 去 掉 。 


<dependency> 
<groupId>org.apache.tomcat .embed</groupId> 
<artifactId>tomcat-embed-jasper</artifactId> 
<scope>provided</scope> 

</dependency> 

<dependency> 
<groupId>javax.servlet</groupId> 
<artifactId>jstl</artifactId> 
<scope>provided</scope> 

</dependency> 

<dependency> 
<groupId>javax.servlet</groupId> 
<artifactId>javax.servlet-api</artifactId> 
<scope>provided</scope> 

</dependency> 


同时 ， 集 成 JSP, EDA f ISP 页 面 ， 这 里 把 ISP 页 面 hellojsp 放 在 了 
/demo/src/main/webapp/view 下 ， 在 hello.jsp 页 面 还 是 遍历 集成 Thymeleaf 时 用 的 users. 


<%@ page language-"java" contentType-"text/html; charset=utf-8" 
pageEncoding-"utf-8"$» 
«$80 taglib prefix-"c" uri-"http://java.sun.com/jsp/jstl/core"$» 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"» 
«html» 
<head> 
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<meta http-equiv-"Content-Type" content-"text/html; charset=utf-8"> 
<title>Insert title here</title> 


</head> 
<body> 
<table border="1"> 
<thead> 
<tr> 
<th> 序 号 </th> 
<th> 姓 名 </th> 
<th> 年 龄 </th> 
</tr> 
</thead> 
<c:forEach var="data" items="${users}" varStatus="loop"> 
<tr> 
<td>${loop.index + 1}</td> 
<td>${data.name}</td> 
<td>${data.age}</td> 
</tr> 
</c: forEach> 
</table> 
</body> 
</html> 


然后 还 需要 在 application.properties 中 设置 view 的 映射 关系 。 


spring.mvc.view.prefix=/view/ 
spring.mvc.view.suffix=.jsp 


最 后 在 浏览 器 中 输入 URL “http://localhost:8081/helloworld/hello4” , 152-44 users 列表 显 
示 到 页 面 中 ， 如 图 9-4 所 示 。 


localhost: 


图 9-4 


9.2 Spring Boot Z Data 


在 上 一 节 介绍 了 Spring Boot 集成 Web 层 ， 其 中 页 面 显示 的 数据 是 在 User 类 中 创建 的 ， 
但 通常 页 面 显示 的 数据 是 从 数据 库 或 者 其 他 地 方 获取 的 ， 本 节 就 来 介绍 Spring Boot 集成 Data 
层 操 作 ， 主 要 包含 Spring Boot 集成 MyBatis、Redis、RabbitMQ 3X 3 种 。 
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9.2.1 Spring Boot 集成 MyBatis 


在 上 节 中 通过 getUsers() 方 法 来 获取 用 户 列表 显示 在 页 面 中 ， 如 果 将 user 数据 放 在 数据 库 
中 使 用 MyBatis 来 获取 又 是 怎么 操作 的 呢 ? 我 们 也 通过 这 个 例子 来 了 解 Spring Boot 集成 
MyBatis 方法 。Spring Boot 集成 MyBatis 一 般 有 两 种 方式 : 一 个 是 基于 注解 的 ， 一 个 是 基于 
xml 配置 的 。 


1. 基于 注解 的 MyBatis 集成 


CIO 引入 依赖 。 因 为 是 集成 MyBatis ， 肯 定 是 要 引入 MyBatis 相关 的 依赖 
mybatis-spring-boot-starter ， 同时 用 的 是 MySQL ， 所 以 也 需要 引入 MySQL 相关 的 
mysql-connector-java 依赖 。 

<dependency> 

<groupId>org.mybatis.spring.boot</groupId> 
<artifactId>mybatis-spring-boot-starter</artifactId> 
<version>1.3.2</version> 

</dependency> 

<dependency> 

<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>8.0.11</version> 

</dependency> 


(2) 在 MySQL 中 创建 一 个 名 为 mybatis 的 数据 库 ， 在 里 面 创建 一 个 user 的 表 。 在 User 
类 基础 上 增加 了 一 个 id 属性 ， 这 样 方便 与 数据 库 的 表 对 照 。 


user X: 


CREATE TABLE "user! ( 
^id? int(11) NOT NULL AUTO INCREMENT, 
^name^ varchar(20) DEFAULT NULL, 
^age" int(11) DEFAULT NULL, 
PRIMARY KEY (`id`) 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


User 类 : 


package com.example.demo; 

public class User { 
private int id; 
private String name; 


private int age; 
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public int getId() { 
return id; 


) 


public void setId(int id) { 
this.id - id; 


) 


public int getAge() ( 


) 


return age; 


public void setAge(int age) ( 


) 


this.age 


7 age; 


public String getName() ( 
return name; 


) 


public void setName(String name) ( 
this.name 


$ 
} 


name; 
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(3) 把 model 与 操作 数据 库 的 SQL 对 照 起 来 ， 用 什么 对 照 呢 ? 创建 一 个 mapper, M 
(Insert, @Delete, @Update. @Select 注解 分 别 对 应 MyBatis 中 的 select. delete, update, select 
元 素来 实现 User 类 与 user 表 的 关联 。 

@Results 注解 来 映射 查询 结果 集 到 实体 类 属性 ， 当 数据 库 字 段 名 与 实体 类 对 应 的 属性 名 
不 一 致 时 ， 可 以 使 用 @Results 映射 来 将 其 对 应 起 来 。column 为 数据 库 字 段 名 ，porperty 为 实 
体 类 属性 名 ，jdbcType 为 数据 库 字 段 数据 类 型 ，id 为 是 否 为 主键 。 

当 这 段 @Results 代码 需要 在 多 个 方法 用 到 时 ， 为 了 提高 代码 复 用 性 ， 我 们 可 以 为 这 个 
@Results 注解 设置 id， 然 后 使 用 @ResultMap 注解 来 复 用 这 段 代码 。 


package com.example.mapper; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


public 


java.util.List; 


org. 
org. 


org 


org. 
org. 
org. 
org. 


org 


apache. 
apache. 
.apache. 
apache. 
apache. 
apache. 
apache. 
.apache. 


ibatis 
ibatis 
ibatis 


ibatis. 


ibatis 
ibatis 
ibatis 
ibatis 


-annotations. 
-annotations. 
-annotations. 
annotations. 
-annotations. 
-annotations. 
-annotations. 
. type. JdbcType; 


com.example.demo.User; 


interface UserMapper { 


@Select ("SELECT * FROM user") 


Delete; 
Insert; 
Result; 
ResultMap; 
Results; 
Select; 
Update; 
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@Results (id="userMap", value={ 


@Result (property = "id",column = "id", jdbcType=JdbcType. INTEGER, 


id-true), 


@Result (property = "age",column = "age",jdbcType-JdbcType.INTEGER) 


@Result (property = "name", column = "name", jdbcType-JdbcType. VARCHAR) 


}) 
List<User> getAll(); 


@Select ("SELECT * FROM user WHERE id = #{id}") 
@ResultMap (value="userMap") 
User getOne(int id); 


@Insert ("INSERT INTO user(name,age) VALUES (#{name}, #{age})") 
void insert (User user); 


@Update ("UPDATE user SET name=#{userName},age=#{age} WHERE id =#{id}") 
void update(User user); 


@Delete ("DELETE FROM user WHERE id =#{id}") 
void delete(int id); 
} 


(4) 配置 扫描 。 上 面 配置 了 mapper， 那 怎么 让 系统 知道 mapper 放 在 哪里 呢 ? 于 是 有 了 


@MapperScan 注解 。 在 HelloWorldApplication 中 使 用 @MapperScan 将 com.example.mapper 
包 中 的 映射 文件 配置 进项 目 中 。 


@MapperScan ("com.example.mapper") 
@SpringBootApplication 
public class HelloWorldApplication { 


(5) TE X UserMapper, 获取 数据 。 在 HelloWorldController 中 注入 UserMapper, 在 hello6 


方法 中 使 用 userMapper 获取 数据 库 中 的 数据 。 


@Autowired 
Private UserMapper userMapper; 


@RequestMapping (value = "/hello6.do",method = RequestMethod. GET) 
public String hello6(Model model) { 

model.addAttribute("users", userMapper.getAll()); 

return "hello"; 
H 


(6) 在 浏览 器 中 输入 url“http:Wlocalhost:8081l/helloworld/hello6.do”， 可 以 将 数据 库 中 的 


数据 查询 出 来 显示 到 页 面 中 ， 如 图 9-5 所 示 。 
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图 9-5 
2. 基于 XML 引入 MyBatis 


一 般 简单 的 增 、 删 、 改 、 查 SQL 可 以 使 用 注解 来 实现 ， 但 对 于 复杂 的 SQL 还 是 需要 使 用 
XML 来 进行 配置 , 这 里 在 上 面 demo 的 基础 上 来 介绍 Spring Boot 基于 XML 引入 MyBatis。 如 
果 使 用 XML 进行 配置 ,在 interface UserMapper 中 的 这 些 注 解 就 不 能 再 用 了 ， 可 以 先 把 里 面 
的 注解 注释 。 注 解 注释 之 后 ， 需 要 怎么 配置 将 SQL 与 interface UserMapper 中 的 方法 对 照 上 
We? 这 里 在 resources 包 下 创建 mybatis 文件 夹 ， 在 mybatis 文件 夹 下 创建 mybatis-config.xml 
配置 文件 和 用 于 映射 xml 存放 mapper 文件 夹 ， 在 mapper 文件 夹 中 创建 UserMapper.xml (用 
于 与 SQL 映射 ) ，interface UserMapper 中 的 方法 通过 UserMapper.xml 元 素 中 的 id 相关 联 。 


mybatis-config.xml: 


<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http: //mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
<typeAlias alias="Integer" type="java.lang.Integer" /> 
<typeAlias alias="Long" type="java.lang.Long" /> 
<typeAlias alias="HashMap" type="java.util.HashMap" /> 
<typeAlias alias="LinkedHashMap" type="java.util.LinkedHashMap" /> 
<typeAlias alias="ArrayList" type="java.util.ArrayList" /> 
<typeAlias alias="LinkedList" type="java.util.LinkedList" /> 
</typeAliases> 
</configuration> 


UserMapper.xml: 


<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" > 
<mapper namespace="com.example.mapper.UserMapper" > 
<resultMap id="BaseResultMap" type="com.example.demo.User" > 
<id column-"id" property-"id" jdbcType-"NUMERIC" /> 
«result column-"name" property-"name" jdbcType-"VARCHAR" /> 
«result column-"age" property-"age" jdbcType="NUMERIC" /> 
</resultMap> 


<sql id="Base_Column_List" > 


id, name, age 
</sql> 
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<select id-"getAll" resultMap="BaseResultMap" > 
SELECT 
<include refid="Base_Column_List" /> 
FROM user 

</select> 


<select id-"getOne" parameterType="java.lang. Integer" 
resultMap="BaseResultMap" > 
SELECT 
<include refid="Base_Column_List" /> 
FROM user WHERE id = #{id} 
</select> 


<insert id-"insert" parameterType="com.example.demo.User" > 
INSERT INTO user (name,age) VALUES (#{name}, #{age}) 
</insert> 


«update id-"update" parameterType="com.example.demo.User" > 
UPDATE user SET 
<if test="name != null">name = #{name},</if> 
<if test="age != null">age = #{age}</if> 
WHERE id = #{id} 
</update> 


<delete id-"delete" parameterType="java.lang.Integer" > 
DELETE FROM user WHERE id =#{id} 
</delete> 
</mapper> 


这 些 新 增 之 后 需要 把 新 建 的 xml 配置 到 mybatis 中 ， 让 它 起 作用 ， 所 以 需要 在 
application.properties 配置 mybatis 的 一 些 属性 ， 设 置 配置 文件 和 映射 文件 的 位 置 。 


mybatis.type-aliases-package=com.example.demo 
mybatis.config-location-classpath:mybatis/mybatis-config.xml 
mybatis.mapper-locations-classpath:mybatis/mapper/*.xml 


修改 hello6 方法 ， 在 方法 中 将 id=1 的 user 的 age 更 改 为 27 之 后 再 查询 user. 


GRequestMapping (value = "/hello6.do",method = RequestMethod. GET) 
public String hello6(Model model) { 

User user=new User (); 

user.setAge (27); 

user.setId(1); 

userMapper.update (user) ; 

model.addAttribute("users", userMapper.getAll()); 

return "hello"; 
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启动 项 目 ， 在 浏览 器 中 输入 url “http://localhost:808 l/helloworld/hello6.do" , TI LA i 
示 出 用 户 列 表 ， 用 户 id=1 的 age 已 经 修改 为 了 27， 如 图 9-6 Pros. 


SS ~ © localhost:8081/helloworld/hello6.do 
序号 | 姓名 | 年龄 
1 小 明 ||27 

图 9-6 


图 9-7 所 示 是 项 目的 目录 结构 ， 方 便 读 者 在 学 习 的 时 候 参考 。 


S| 本 
v $9. src/main/java 
v 出 com.example.demo 
> DS ConfigClass.java 
> GF HelleWerldApplicationjav. 
» [9$ HelleWorldControllerjava 
[D$ IndexControllerjava 
> [f$ PersonSettingjava 
> D) Userjava 
v B com.example.mapper 
> [ff UserMapperjava 
v dB com.example.services 


D) HelloService java 


v @® src/main/resources 
v © mybatis 
v © mapper 


四 UserMapper.xml 


网 mybatis-config.xml 
5 static 
> © templates 
i) application-bean.xml 
局 application-dev.properties 


B application-prod.properties 
局 application.properties 

B banner.txt 

因 log4j2.xml 

R logback.xml 

A test.oroverties 


图 9-7 
9.2.2 Spring Boot 集成 Redis 


Redis 是 一 个 开源 的 使 用 ANSI C 语言 编写 、 支持 网 络 、 可 基于 内 存 亦 可 持久 化 的 日 志 型 、 
Key-Value 数据 库 ， 并 提供 多 种 语言 的 API。 至 于 Redis 的 作用 场景 ， 这 些 暂 不 列举 。 

Lettuce fil Jedis 的 都 是 连接 Redis Server 的 客户 端 程序 。Jedis 在 实现 上 是 直 连 Redis Server, 
多 线程 环境 下 非 线程 安全 ， 除 非 使 用 连接 池 ， 为 每 个 Jedis 实例 增加 物理 连接 。Lettuce 基于 
Netty 的 连接 实例 CStatefulRedisConnection) ， 可 以 在 多 个 线程 间 并 发 访问 ， 且 线程 安全 ， 满 
足 多 线程 环境 下 的 并 发 访问 ,同时 它 是 可 伸缩 的 设计 , 一 个 连接 实例 不 够 的 情况 也 可 以 按 需 增 
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加 连接 实例 。 本 节 主 要 介绍 Spring Boot 如 何 使 用 Lettuce 集成 Redis。 为 了 演示 集成 Redis， 这 
里 新 建 了 一 个 名 为 SpringBootRedis 的 项 目 ， 并 使 用 命令 行 redis-server.exe redis.windows.conf 
在 本 地 启动 Redis 服务 ， 如 图 9-8 所 示 。 


图 9-8 


1. 引入 依赖 


访问 Redis 需要 引入 spring-boot-starter-data-redis、commons-pool2 两 个 依赖 ， 同 时 引入 了 
集成 JSP 页 面相 关 的 依赖 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-redis</artifactId> 

</dependency> 

<dependency> 
<groupId>org.apache.commons</groupId> 
<artifactId>commons-pool2</artifactId> 

</dependency> 

<dependency> 
<groupId>org. apache. tomcat .embed</groupId> 
<artifactId>tomcat-embed-jasper</artifactId> 
<scope>provided</scope> 

</dependency> 

<dependency> 
<groupId>javax.servlet</groupId> 
<artifactId>jstl</artifactId> 
<scope>provided</scope> 

</dependency> 

<dependency> 
<groupId>javax.servlet</groupId> 
<artifactId>javax.servlet-api</artifactId> 
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<scope>provided</scope> 
</dependency> 


2. 属性 配置 


访问 Redis 同时 还 需要 配置 Redis 地 址 、 端 口 等 信息 ， 同 时 设置 Spring Boot 集成 JSP 页 面 
的 配置 信息 。 


spring.redis.host-127.0.0.1 
spring.redis.password= 
spring.redis.port= 6379 
spring.redis.timeout=1000 
spring.redis.database=0 
spring.redis.lettuce.pool.min-idle=0 
spring.redis.lettuce.pool.max-idle=8 
spring.redis.lettuce.pool.max-wait--1ms 
spring.redis.lettuce.pool.max-active-8 
spring.mvc.view.prefix=/view/ 
spring.mvc.view.suffix=.jsp 


3. 实例 


Redis 一 般 都 是 通过 key-value 存储 数据 ，key 一 般 都 是 String， 但 是 value 可 能 不 一 样 ， 
一 般 有 两 种 :String 和 Object: 如 果 k-v 都 是 String 类 型 ,我 们 可 以 直接 用 StringRedisTemplate， 
这 个 也 是 官方 建议 的 , 也 是 最 方便 的 , 直接 导入 即 用 , 无 须 多 余 配置 ! 如 果 k-v 是 Object 类 型 ， 
则 需要 自 定义 RedisTemplate。 

首先 在 com.example.config 包 中 增加 RedisCacheAutoConfiguration 类 ， 在 类 中 自 定 义 
RedisTemplate. 


@configuration 
@AutoConfigureAfter (RedisAutoConfiguration.class) 
public class RedisCacheAutoConfiguration { 
@Bean 
public RedisTemplate<String, Serializable> 
redisCacheTemplate (LettuceConnectionFactory 
redisConnectionFactory) { 
RedisTemplate<String, Serializable> template = new RedisTemplate<>() ; 
template. setKeySerializer (new StringRedisSerializer()); 
template.setValueSerializer (new 
GenericJackson2JsonRedisSerializer()); 
template.setConnectionFactory (redisConnectionFactory); 
return template; 


} 
其 次 还 是 定义 了 User 对 象 ， 同 时 重 写 了 toString() 方 法 。 
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package com.example.model; 
import java.io.Serializable; 
public class User implements Serializable{ 
private static final long serialVersionUID = 1L; 
private int id; 
private String name; 
private int age; 


public int getId() { 
return id; 

} 

public void setId(int id) { 
this.id = id; 

} 

public int getAge() { 
return age; 

} 

public void setAge(int age) { 
this.age = age; 

} 

public String getName() { 
return name; 

} 

public void setName(String name) { 
this.name = name; 


public User(int id, String name, int age) { 
super (); 
this.id = id; 
this.name = name; 
this.age = age; 


public User() { 
super (); 


@Override 
public String toString() { 
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return "User [id=" + id + ", name=" + name + ", age=" + age + "]"; 


) 


然后 新 建 mdexController， 并 注入 StringRedisTemplate、RedisTemplate， 同 时 实例 了 User 
对 象 , 使 用 StringRedisTemplate 通过 set 方法 向 Redis 中 写 入 User 对 象 的 toString() 返 回 的 字符 
串 ， 并 通过 get 方法 获取 到 对 应 的 值 ， 使 用 RedisTemplate， 也 是 一 样 ， 只 是 保存 的 是 User 
对 象 。 


package com.example.demo; 

import java.io.Serializable; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.data.redis.core.RedisTemplate; 
import org.springframework.data.redis.core.StringRedisTemplate; 
import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 


import com.example.model.User; 


@controller 
GRequestMapping ("/index") 
public class IndexController ( 
GAutowired 
private StringRedisTemplate stringRedisTemplate; 


GAutowired 
private RedisTemplate<String, Serializable» redisCacheTemplate; 


@RequestMapping (value = "/redistest.do",method = RequestMethod.GET) 
public String getallusers (Model model) ( 
User user-new User(1,"/|8j",27); 
String strkey-"stringuser"; 
stringRedisTemplate.opsForValue().set(strkey, user.toString()); 
final String valueStr - 
stringRedisTemplate.opsForValue().get(strkey); 
model.addAttribute(strkey, valueStr); 
String objkey = "objuser"; 
redisCacheTemplate.opsForValue().set(objkey, user); 
user = (User) redisCacheTemplate.opsForValue().get(objkey); 
model.addAttribute(objkey, user); 
return "index"; 
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和 集成 MyBatis 时 一 样 ， 在 src/main/webapp 下 新 建 view 文件 夹 ， 并 在 文件 夹 里 面 创建 了 
index.jsp 页 面 。 在 index.jsp 中 显示 从 Redis 获取 到 的 字符 串 ${stringuser} 和 $ {objuser} 对 象 。 


<%@ page language-"java" contentType-"text/html; charset=utf-8" 


pageEncoding-"utf-8"$» 
«$8 taglib prefix-"c" uri-"http://java.sun.com/jsp/jstl/core"$» 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"» 
<html> 
<head> 
<meta http-equiv-"Content-Type" content-"text/html; charset=utf-8"> 
<title>Insert title here</title> 
</head> 
<body> 
${stringuser} 
<table border="1"> 
<thead> 
<tr> 
«th»H E «/th» 
<th> 姓 名 </th> 
<th> 年 龄 </th> 
</tr> 
</thead> 
<tr> 
<td>${objuser.id}</td> 
<td>${objuser.name}</td> 
<td>${objuser.age}</td> 
</tr> 
</table> 
</body> 
</html> 


最 后 在 浏览 器 中 输入 url “http://localhost:8080/index/redistest.do” , FJ LAJEJA Redis 中 获取 
到 的 字符 串 和 User 对 象 显 示 到 页 面 中 ， 如 图 9-9 所 示 。 


(o) (ay localhost: 


id=1, name= 小 明 . age=27] 
ee | pt) 
| 小明 |27 


9-9 
9.2.3 Spring Boot 集成 MyBatis 使 用 Redis 做 缓存 


上 一 小 节 介 绍 了 Spring Boot 集成 Redis， 本 小 节 学 习 一 下 MyBatis 操作 中 使 用 Redis 做 组 
存 。 这 里 其 实 主要 学 习 几 个 注解 : @CachePut、@Cacheable、@CacheEvict、@CacheConfig。 
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1. @Cacheable 
@Cacheable 的 作用 主要 针对 方法 配置 ， 能 够 根据 方法 的 请 求 参数 对 其 结果 进行 缓存 ， 参 
数 如 表 9-1 所 示 。 
表 9-1 @Cacheable 的 参数 


解释 5 f 

缓存 的 名 称 ， 在 Spring 配置 文件 中 定义 ， 必 须 指定 至 | @Cacheable(value="mycache") 

消 一 个 (&)Cacheable(value- ("cache1", "cache2"} 
缓存 的 key， 可 以 为 空 。 如 果 指 定 ， 就 要 按照 SpEL X 


@Cacheable(value="testcache", 


达 式 编写 ， 如 果 不 指定 ， 那 么 默认 按照 方法 的 所 有 参 
key="#userName") 


数 进行 组 合 
缓存 的 条 件 ， 可 以 为 空 ， 使 用 SpEL 编写 ， 返 回 true | @Cacheable(value="testcache", 
或 者 false， 只 有 为 true 才 进 行 缓存 condition="#fuserName.length()>2") 


2. @CachePut 

@CachePut 的 作用 主要 针对 方法 配置 ， 能 够 根据 方法 的 返回 值 对 其 结果 进行 缓存 。 和 
@Cacheable 不 同 的 是 ， 它 每 次 都 会 触发 真实 方法 的 调用 ， 其 他 地 方 写 的 是 根据 方法 的 请 求 参 
数 对 其 结果 进行 缓存 ， 实 际 是 对 方法 返回 值 进行 缓存 的 ， 参 数 如 表 9-2 所 示 。 


表 9-2 @CachePut 的 参数 


缓存 的 名 称 ， 在 Spring 配置 文件 中 定义 ， 必 须 指定 至 
b—^ 

缓存 的 key， 可 以 为 空 。 如 果 指 定 ， 就 要 按照 SpEL d 
key 达 式 编写 ， 如 果 不 指 定 ， 那 么 默认 按照 方法 的 所 有 参 
数 进行 组 合 

缓存 的 条 件 ， 可 以 为 空 ， 使 用 SpEL 编写 ， 返回 true | @CachePut(value="testcache", 
或 者 false， 只 有 为 true 才 进 行 缓存 condition="#userName.length(Q)>2") 


@CachePut(value="my cache") 


@CachePut(value="testcache", 
key="#userName") 


condition 


3. @CachEvict 


@CachEvict 的 作用 主要 针对 方法 配置 ， 能 够 根据 一 定 的 条 件 对 缓存 进行 清空 ， 参 数 如 表 
9-3 所 示 。 


表 9-3 @CachEvict 的 参数 


mom 5 F 
缓存 的 名 称 , 在 Spring 配置 文件 中 定义 ,必须 指定 至 
D-t 

缓存 的 key， 可 以 为 空 。 如 果 指 定 ， 就 要 按照 SpEL 
表达 式 编写 ; 如 果 不 指定 ， 那 么 默认 按照 方法 的 所 有 
参数 进行 组 合 


@CacheEvict(value="my cache") 


@CacheEvict(value="testcache", 
key="#userName") 
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(RR) 


参数 E 例 ” 子 
缓存 的 条 件 ， 可 以 为 空 ， 使 用 SpEL 编写 ， 返 回 true | @CacheEvict(value="testcache", 
或 者 false， 只 有 为 tue 才 进 行 缓存 condition="#userName.length()>2") 
是 否 清空 所 有 缓存 内 容 ， 默 认为 false， 如 果 指 定 为 | @CachEvict(value="testcache", 


condition 


allEntries 


tmue， 则 方法 调用 后 将 立即 清空 所 有 缓存 allEntries=true) 

是 否 在 方法 执行 前 就 清空 ， 默 认为 false， 如 果 指 定 为 
beforelnvocation | tue， 则 在 方法 还 没有 执行 的 时 候 就 清空 缓存 ， 默 认 情 

况 下 ， 如 果 方 法 执行 抛 出 异常 ， 则 不 会 清空 缓存 


@CachEvict(value="testcache", 
beforeInvocation-true) 


4. @CacheConfig 


所 有 的 @Cacheable() 里 面 都 有 一 个 value="xxx" 的 属性 。 显 然 ， 如 果 方 法 多 了 ， 写 起 来 也 
是 挺 累 的 ， 如 果 可 以 一 次 性 声明 完 就 省 事 了 。 有 了 @CacheConfig 这 个 配置 (@CacheConfig 
是 类 级 别 的 注解 ， 允 许 通 过 @CacheConfig(cacheNames="user") 这 种 方式 设置 缓存 的 名 字 ) ， 如 
果 在 你 的 方法 中 写 别 的 名 字 ， 那 么 依然 以 方法 的 名 字 为 准 。 

下 面 用 一 个 实例 来 进一步 了 解 几 个 注解 的 使 用 。 实 例 是 在 上 一 节 Spring Boot 集成 Redis 
的 基础 上 进行 修改 的 。 

首先 ， 引 入 MyBatis 和 MySQL 的 相关 依赖 ， 并 在 application.properties 中 设置 MyBatis 
相关 的 属性 。 


<dependency> 
<groupId>org.mybatis.spring.boot</groupId> 
<artifactId>mybatis-spring-boot-starter</artifactId> 
<version>1.3.2</version> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>8.0.11</version> 

</dependency> 


spring.datasource.driverClassName = com.mysql.cj.jdbc.Driver 

spring.datasource.url-jdbc:mysql://127.0.0.1:3306/mybatis?useUnicode-tru 
e&characterEncoding-UTF-8&serverTimezone-UTC&useSSL-true 

spring.datasource.username - root 

spring.datasource.password - 123456 


然后 ， 新 增 UserMapper 将 Model 与 数据 库 SQL 关联 ， 在 MyBatis 章节 已 有 提 过 。 
package com.example.mapper; 
import java.util.List; 


import org.apache.ibatis.annotations.Delete; 
import org.apache.ibatis.annotations.Insert; 
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import org.apache.ibatis.annotations.Mapper; 
import org.apache.ibatis.annotations.Result; 
import org.apache.ibatis.annotations.ResultMap; 
import org.apache.ibatis.annotations.Results; 
import org.apache.ibatis.annotations.Select; 
import org.apache.ibatis.annotations.Update; 
import org.apache.ibatis.type.JdbcType; 

import com.example.model.User; 


@Mapper 
public interface UserMapper{ 


@Select ("SELECT * FROM user") 
@Results (id="userMap", value={ 


@Result (property = "id",column = "id", jdbcType=JdbcType . INTEGER) 
@Result (property = "age",column = "age", jdbcType=JdbcType. INTEGER) , 
@Result (property = "name", column = "name", jdbcType=JdbcType . VARCHAR) 


} 
List<User> getAll(); 


@Select ("SELECT * FROM user WHERE id = #{id}") 
@ResultMap (value="userMap") 
User getOne (int id); 


@Insert ("INSERT INTO user(name,age) VALUES (#{name}, #{age})") 
void insert (User user); 


@Update ("UPDATE user SET name=#{name},age=#{age} WHERE id =#{id}") 
void update (User user); 


@Delete ("DELETE FROM user WHERE id =#{id}") 
void delete (int id); 
H 
原本 计划 是 在 Mapper 层 上 增加 cache 注解 ， 但 由 于 update 返回 值 为 void， 所 以 这 里 又 增 
加 了 service 层 , mapper 层 算 是 DAO 层 。 使 用 了 @MapperScan 注解 来 设置 mapper 接口 对 应 的 
包 名 。 使 用 @CacheConfig 注解 设置 缓存 的 名 字 。 


package com.example.service; 
import java.util.List; 


import org.mybatis.spring.annotation.MapperScan; 
import org.springframework.beans.factory.annotation.Autowired; 
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import 
import 
import 
import 
import 


import 
import 
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org.springframework.cache.annotation.CacheConfig; 
org.springframework.cache.annotation.CacheEvict; 
org.springframework.cache.annotation.CachePut; 
org.springframework.cache.annotation.Cacheable; 
org.springframework.stereotype.Service; 


com.example.mapper.UserMapper; 
com.example.model.User; 


@MapperScan (basePackages = "com.example.mapper") 
@Service 


GCacheConfig (cacheNames="user") 


public 


class UserService { 


@Autowired 


private UserMapper userMapper; 


public List<User> getAll() 


{ 


return userMapper.getAll(); 


@Cacheable (key = "#p0") 
public User getOne(int id) 


í 


return userMapper.getOne (id); 


public void insert (User user) 


{ 


userMapper. insert (user); 


@CachePut (value="user", key = "#p0.id") 
public User update(User user) 


t 


userMapper.update (user) ; 
return user; 


GCacheEvict (value-"user",key ="#p0",allEntries=true) 
public void delete(int id) 


{ 


userMapper.delete (id); 
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上 面 创建 完 之 后 就 可 以 在 IndexController 中 注入 UserService 使 用 缓存 注解 ， 在 Controller 
中 增加 了 下 面 的 几 个 方法 ， 用 来 对 user 进行 增 、 删 、 改 、 查 。 


@Autowired 
Private UserService userService; 


@RequestMapping (value = "/alluser.do",method = RequestMethod.GET) 
public String getall(Model model) { 
List<User> users=userService.getAll(); 
model.addAttribute("users", users); 
return "index"; 
} 
@RequestMapping (value = "/insert.do",method = RequestMethod. GET) 
public String adduser (Model model) ( 
User user=new User(); 
user.setName ("cuiyw"); 
user.setAge (27); 
userService.insert (user); 
return "forward:/index/alluser.do"; 
) 
GRequestMapping (value = "/getuserbyid.do/{id}",method = RequestMethod. GET) 
public ModelAndView GetUserById(@PathVariable("id") int id) { 
System. out.println (id); 
User user-userService.getOne (id); 
System.out.println(user.toString()); 
ModelAndView modelAndView - new ModelAndView ("index"); 
List<User> users-new ArrayList<User>(); 
users.add (user); 
modelAndView.addObject("users", users); 
return modelAndView; 
) 
GRequestMapping (value = "/deleteuserbyid.do/{id}",method 
RequestMethod.GET) 
public String DeleteUserById(@PathVariable("id") int id) ( 
userService.delete (id); 
return "forward:/index/alluser.do"; 


H 
GRequestMapping (value = "/updateuserbyid.do/(id)",method 
RequestMethod. GET) 

public String UpdateUserByid(@PathVariable("id") int id) { 
User user-userService.getOne (id); 
System.out.println(user.toString()); 
user.setAge (28); 
System.out.println(user.toString()); 
userService.update (user); 
System.out.println(user.toString()); 
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return "forward:/index/alluser.do"; 
H 


最 后 也 是 经 常 遗漏 的 一 步 ， 设 置 @EnableCaching。 需 要 在 main 方法 上 面 设置 启动 缓存 。 


@ComponentScan (basePackages={"com.example.config", "com.example.demo", "co 
m.example.service"}) 

@SpringBootApplication 

@EnableCaching 

public class SpringBootRedisApplication { 


public static void main(String[] args) { 
SpringApplication. run(SpringBootRedisApplication.class, args); 
} 
} 


启动 程序 , 在 浏览 器 输入 Url http://localhost:8080/index/getuserbyid.do/1”, 之 后 启动 Redis 
客户 端 ， 输 入 命令 keys * 来 查看 Redis 缓存 中 的 数据 ， 如 图 9-10、 图 9-11 所 示 。 


localhost: 


图 9-10 


图 9-11 
9.24 Spring Boot 集成 RabbitMQ 


1. RabbitMQ 的 介绍 


RabbitMQ 是 消息 中 间 件 的 一 种 。 消 息 中 间 件 即 分 布 式 系统 中 完成 消息 的 发 送 和 接收 的 基 
础 软件 。 消 息 中 间 件 的 工作 过 程 可 以 用 生产 者 消费 者 模型 来 表示 , 即 生产 者 不 断 地 向 消息 队列 
发 送信 息 ， 而 消费 者 从 消息 队列 中 消费 信息 ， 有 具体 过 程 如 图 9-12 所 示 。 

从 图 9-12 可 看 出 ， 对 于 消息 队列 来 说 ， 生 产 者 、 消 息 队 列 、 消 费 者 是 最 重要 的 三 个 概念 ， 
生产 者 发 消息 到 消息 队列 中 去 ， 消 费 者 监听 指定 的 消息 队列 ， 并 且 当 消息 队列 收 到 消息 之 后 ， 
接收 消息 队列 传 来 的 消息 , 并 且 给 予 相应 的 处 理 。 消 息 队 列 常 用 于 分 布 式 系统 之 间 互 相信 息 的 
传递 。 


208 


#98 Spring Boot HMA 


生产 者 


producer 


A 


图 9-12 


对 于 RabbitMQ 来 说 ,除了 这 三 个 基本 模块 以 外 ,还 添加 了 一 个 模块 , 即 交 换 机 (Exchange)。 
它 使 得 生产 者 和 消息 队列 之 间 产 生 了 隔离 , 生产 者 将 消息 发 送 给 交换 机 , 而 交换 机 则 根据 调度 
策略 把 相应 的 消息 转发 给 对 应 的 消息 队列 。 

交换 机 的 主要 作用 是 接收 相应 的 消息 并 且 绑 定 到 指定 的 队列 。 交换机 有 四 种 类 型 ,分 别 为 
Direct、 topic、headers、Fanout。 

Direct 是 RabbitMQ 默认 的 交换 机 模式 ， 也 是 最 简单 的 模式 。 在 创建 消息 队列 的 时 候 ， 指 
定 一 个 BindingKey。 当 发 送 者 发 送 消息 的 时 候 ， 指 定 对 应 的 Key。 当 Key 和 消息 队列 的 
BindingKey 一 致 的 时 候 ， 消 息 将 会 被 发 送 到 该 消息 队列 中 。 

topic 转发 信息 主要 是 依据 通配符 ， 队 列 和 交换 机 的 绑 定 主要 是 依据 一 种 模式 〈 通 配 符 + 
FRE) ， 而 当 发 送 消息 的 时 候 ， 只 有 指定 的 Key 和 该 模式 相 匹 配 的 时 候 消 息 才 会 被 发 送 到 
该 消息 队列 中 。 

headers 也 是 根据 一 个 规则 进行 匹配 ， 在 消息 队列 和 交换 机 绑 定 的 时 候 会 指定 一 组 键 值 对 
规则 ， 而 发 送 消息 的 时 候 也 会 指定 一 组 键 值 对 规则 ， 当 两 组 键 值 对 规则 相 匹 配 的 时 候 ， 消 息 会 
被 发 送 到 匹配 的 消息 队列 中 。 

Fanout 是 路 由 广播 的 形式 ， 将 会 把 消息 发 给 绑 定 它 的 全 部 队列 ， 即 便 设置 了 key， 也 会 被 
忽略 。 


2. Spring Boot 整合 RabbitMQ(Direct 模式 ) 
Spring Boot 整合 RabbitMQ 非常 简单 ， 首 先 还 是 pom.xml 引入 依赖 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-amgp</artifactId> 
</dependency> 


在 application.properties 中 配置 RabbitMQ 相关 的 信息 ， 并 首先 启动 RabbitMQ 实例 ， 创 建 
两 个 queue， 如 图 9-13 所 示 。 


hello D idle 0 0 0 0.00/s 0.00/s 0.00/: 


object D idle 0 0 0 0.00/s 0.00/s 0.00/: 
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spring.application.name-spirng-boot-rabbitmq 
spring.rabbitmq.host-127.0.0.1 

spring.rabbitmq.port-5672 

spring.rabbitmq.username-admin 

spring.rabbitmq.password-admin 
配置 Queue (消息 队列 ) ， 由 于 采用 的 是 Direct 模式 ， 因 此 需要 在 配置 Queue 的 时 候 指 定 

一 个 键 ， 使 其 和 交换 机 绑 定 。 
@Configuration 
public class RabbitConfig { 


@Bean 
public org.springframework.amqp.core.Queue Queue() { 


return new org.springframework.amqp.core.Queue ("hello"); 


) 


接着 就 可 以 发 送 消息 啦 。 在 Spring Boot 中 ， 我 们 使 用 AmqpTemplate 去 发 送 消息 。 代 码 
如 下 : 


@Component 
Public class HelloSender { 


@Autowired 
private AmqpTemplate rabbitTemplate; 


public void send(int index) { 


String context = "hello Queue "+index + new Date(); 
System.out.println("Sender : " + context); 
this. rabbitTemplate.convertAndSend("hello", context); 


H 

生产 者 发 送 消 息 之 后 , 需要 消费 者 接收 消息 。 这 里 定义 了 两 个 消息 消费 者 , 用 来 模拟 生产 
者 与 消费 者 一 对 多 的 关系 。 

@Component 


@RabbitListener (queues = "hello") 
public class HelloReceiver { 


@RabbitHandler 


public void process(String hello) { 
System.out.println("Receiverl : " + hello); 
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) 


GComponent 


@RabbitListener (queues = "hello") 


public class HelloReceiver2 { 


@RabbitHandler 


public void process(String hello) { 


System. out.print1n("Receiver2 
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" + hello); 


H 
在 单元 测试 中 模拟 发 送 消 息 ， 批 量 发 送 10 条 消息 ， 两 个 接收 者 分 别 接收 了 5 条 消息 ， 如 
图 9-14 所 示 。 
@Autowired 


private HelloSender helloSender; 
@Test 


public void hello() throws Exception { 


for(int i=0;i<10;i++) 
{ 


helloSender.send (i); 


-I2- Tare. === main 
Sender : hello Queue @Sun 
Sender : hello Queue 1Sun 
Sender : hello Queue 2Sun 
Sender : hello Queue 3Sun 
Sender : hello Queue 4Sun 
Sender : hello Queue SSun 
Sender : hello Queue 6Sun 
Sender : hello Queue 7Sun 
Sender : hello Queue 8Sun 
Sender : hello Queue 9Sun 
Receiveri : hello Queue 2018 
Receiver2 : hello Queue 2018 
Receiveri : hello Queue 2018 
Receiverl : hello Queue 2018 
Receiver2 : hello Queue 2018 
Receiveri : hello Queue 2018 
Receiver2 : hello Queue 2018 
Receiveri : hello Queue 2018 
Receiver2 : hello Queue 2018 
Receiver2 : hello Queue 2018 


9-14 


实际 上 RabbitMQ 还 可 以 支持 发 送 对 象 , 由 于 涉及 序列 化 和 反 序 列 化 ,因此 该 对 象 要 实现 
Serilizable 接口 。 这 里 定义 User 对 象 ， 用 来 做 发 送 消息 的 内 容 。 


import java.io.Serializable; 
public class User implements Serializable{ 


private String name; 
private String pwd; 
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public String getPwd() { 
return pwd; 

} 

public void setPwd(String pwd) { 
this.pwd = pwd; 

} 

public String getName() { 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public User(String name, String pwd) { 
this.name = name; 
this.pwd = pwd; 

} 

@Override 

public String toString() { 
return "User(" +"name='" + name + 'V'' +", pwd='" + pwd + '\'' +'}'; 


} 
在 生产 者 中 发 送 User 对 象 。 


@Component 
public class ModelSender { 


@Autowired 
private AmqpTemplate rabbitTemplate; 


public void sendModel (User user) { 


System.out.println("Sender object: " + user.toString()); 
this. rabbitTemplate.convertAndSend("object", user); 


} 
在 消费 者 中 接收 User 对 象 。 


GComponent 
@RabbitListener (queues = "object") 
public class ModelRecevicer { 


GRabbitHandler 
public void process(User user) ( 
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System.out.println("Receiver object : " + user); 


} 
在 单元 测试 中 注入 Modelsender 对 象 ， 实 例 化 User 对 象 ， 然 后 发 送 ， 如 图 9-15 所 示 。 


@Autowired 

private ModelSender modelSender; 

@Test 

public void model() throws Exception { 


User user=new User ("abc","123"); 
modelSender.sendModel (user) ; 


Sender object: User([name-'abc', pwd='123'} 
2018-12-16 17:00:54.174 INFO 12984 --- [ 


2018-12-16 17:00:54.211 INFO 12984 --- [ 
Receiver object : User([name-'abc', pwd-'123']| 


9-15 
3. Spring Boot #& RabbitMQ(Topic 转发 模式 ) 


首先 需要 在 RabbitMQ 服务 端 创建 交换 机 topicExchange , 并 绑 定 两 个 queue: topic. message. 
topic.messages， 如 图 9-16 所 示 。 


To Routing key Arguments 


topic.message 


topic.message 


topic.messages 


图 9-16 
新 建 TopicRabbitConfig， 设 置 对 应 的 queue 45 binding. 


GConfiguration 
public class TopicRabbitConfig ( 


final static String message - "topic.message"; 
final static String messages - "topic.messages"; 
@Bean 


public Queue queueMessage() { 
return new Queue (TopicRabbitConfig.message) ; 
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@Bean 
public Queue queueMessages() { 
return new Queue (TopicRabbitConfig.messages) ; 


@Bean 
TopicExchange exchange() { 
return new TopicExchange ("topicExchange"); 


@Bean 
Binding bindingExchangeMessage (Queue queueMessage, TopicExchange 
exchange) { 
return 
BindingBuilder.bind(queueMessage) .to (exchange) .with("topic.message") ; 


j 


@Bean 
Binding bindingExchangeMessages (Queue queueMessages, TopicExchange 
exchange) { 
return BindingBuilder.bind(queueMessages) .to (exchange). 
with ("topic.#"); 
} 
} 


创建 消息 生产 者 ， 在 TopicSender 中 发 送 3 个 消息 。 


@Component 
Public class TopicSender { 


@Autowired 
Private AmqpTemplate rabbitTemplate; 


public void send() { 
String context = "hi, i am message all"; 
System.out.println("Sender : " + context); 
this. rabbitTemplate.convertAndSend("topicExchange", "topic.1", 
context); 
H 


public void send1() ( 
String context - "hi, i am message 1"; 
System.out.println("Sender : " + context); 
this. rabbitTemplate.convertAndSend ("topicExchange", 
"topic.message", context); 
H 
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public void send2() { 
String context = "hi, i am messages 2"; 
System.out.println("Sender : " + context); 
this. rabbitTemplate.convertAndSend ("topicExchange", 
"topic.messages", context); 
) 
) 


生产 者 发 送 消息 ， 这 里 创建 了 两 个 接收 消息 的 消费 者 。 


QComponent 
@RabbitListener (queues = "topic.message") 
public class TopicReceiver { 


@RabbitHandler 
public void process(String message) { 
System.out.println("Topic Receiverl : " + message); 


) 


GComponent 
@RabbitListener (queues = "topic.messages") 
public class TopicReceiver2 { 


@RabbitHandler 
public void process(String message) { 


System.out.println("Topic Receiver2 : " + message); 


} 
在 单元 测试 中 注入 TopicSender， 利 用 topicSender 发 送 消息 ， 如 图 9-17 所 示 。 


@Autowired 

private TopicSender topicSender; 

@Test 

public void topicSender() throws Exception { 
topicSender.send(); 
topicSender.sendl(); 
topicSender.send2(); 


Sender : hi, i am message all 
Sender : hi, i am message 1 
Sender : hi, i am messages 2 


2018-12-16 18:57:17.284 INFO 11412 --- [ 
Topic Receiver2 : hi, i am message all 
Topic Receiverl : hi, i am message 1 
Topic Receiver2 : hi, i am message 1 
Topic Receiver2 : hi, i am messages 2 

图 9-17 
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从 上 面 的 输出 结果 可 以 看 到 ，Topic Receiver2 匹配 到 了 所 有 消息 ，Topic Receiver! HIE 


配 到 了 1 个 消息 。 


4. Spring Boot 整合 RabbitMQ (Fanout Exchange 形式 ) 
Fanout Exchange 形式 又 叫 广播 形式 ， 因 此 我 们 发 送 到 路 由 器 的 消息 会 使 得 绑 定 到 该 路 由 


器 的 每 一 个 Queue 接收 到 消息 。 首 先 需要 在 RabbitMQ 服务 端 创建 交换 机 fanoutExchange， 并 
绑 定 三 个 queue: fanoutA, fanout.B. fanoutC, "E 9-18 所 示 。 


To Routing key Arguments 


bind 
— 
fanout.8 
Unbind 
fanout.C 


图 9-18 


与 Topic 类 似 ， 新 建 FanoutRabbitConfig， 绑 定 交 换 机 和 队列 。 


GConfiguration 
public class FanoutRabbitConfig ( 


@Bean 
public Queue AMessage() { 
return new Queue ("fanout.A"); 


} 


@Bean 
public Queue BMessage() { 

return new Queue ("fanout.B"); 
} 


@Bean 
public Queue CMessage() { 

return new Queue ("fanout.C"); 
} 


@Bean 
FanoutExchange fanoutExchange() { 

return new FanoutExchange ("fanoutExchange"); 
} 


@Bean 

Binding bindingExchangeA (Queue AMessage, FanoutExchange fanoutExchange) { 
return BindingBuilder.bind(AMessage) .to(fanoutExchange) ; 

H 


GBean 
Binding bindingExchangeB (Queue BMessage, FanoutExchange 


fanoutExchange) { 
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return BindingBuilder.bind(BMessage) .to(fanoutExchange) ; 
H 


@Bean 
Binding bindingExchangeC (Queue CMessage, FanoutExchange 


fanoutExchange) { 
return BindingBuilder.bind(CMessage) .to(fanoutExchange) ; 


} 
创建 消息 生产 者 ， 在 FanoutSender 中 发 送 消息 。 


@Component 
public class FanoutSender { 


@Autowired 
private AmqpTemplate rabbitTemplate; 


public void send() ( 


String context - "hi, fanout msg "; 
: "+ context); 


System.out.println("FanoutSender : 
this.rabbitTemplate.convertAndSend ("fanoutExchange","", context); 


) 
然后 创建 3 个 接收 者 : FanoutReceiverA. FanoutReceiverB, FanoutReceiverC. 


GComponent 
@RabbitListener (queues 
public class FanoutReceiverA { 


= "fanout.A") 


@RabbitHandler 
public void process (String message) { 


System.out.println("fanout Receiver A : " + message); 


} 
GComponent 

@RabbitListener (queues = "fanout.B") 
public class FanoutReceiverB { 


@RabbitHandler 
public void process (String message) { 


System.out.println("fanout Receiver B: " + message); 


) 


GComponent 
@RabbitListener (queues = "fanout.C") 
public class FanoutReceiverC { 


@RabbitHandler 
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public void Process (String message) { 
System.out.println("fanout Receiver C: " + message) ; 


H 
在 单元 测试 中 注入 消息 发 送 者 ， 发 送 消息 。 
@Autowired 

private FanoutSender fanoutSender; 


@Test 
public void fanoutSender() throws Exception { 


fanoutSender.send(); 


H 
从 图 9-19 可 以 看 到 3 个 队列 都 接收 到 了 消息 。 


FanoutSender : hi, fanout msg 
2018-12-16 19:36:44.629 INFO 16324 --- 


fanout Receiver C: hi, fanout msg 
fanout Receiver B: hi, fanout msg 
fanout Receiver A : hi, fanout msg 


图 9-19 


本 节 创 建 的 类 比较 多 ， 结 构 如 图 9-20 所 示 。 也 可 以 直接 查看 demo 源码 了 解 。 


v 各 SpringBootRabbitMQ [boot] 
v $9 src/main/java. 
v dB com.example.config 
> [P FanoutRabbitConfig java 
> [D RabbitConfig java 
D) TopicRabbitConfig java 
v jfi com.example.demo 
G$ FanoutReceiverA java 
G$ FanoutReceiverB java 
> [D$ FanoutReceiverCjava 
» G$ FanoutSenderjava 
B$ HelloReceiver java 
5$ HelloReceiver2 java 
> [5 HelloSenderjava 
G$ ModelRecevicer java 
D$ ModelSenderjava 


> [I$ SpringBootRabbitMaSenderApplicationjav 
» G$ TopicReceiverjava 
G$ TopicReceiver2 java 
> DS TopicSenderjava 
v ffi com.example.model 


D) Userjava 
v (9 src/main/resources 
Æ application.properties 
v @ sreftest/java 
v 出 com.example.demo 
v [J| SpringBoctRabbitMqSenderApplicationTes 
~ © SpringBootRabbitMaSenderApplication ¥ 
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Spring Boot 之 集成 其 他 工具 


在 上 一 节 介绍 了 Spring Boot 集成 Data Jz, 本 节 介 绍 开发 常用 的 几 个 工具 , 主要 包括 Druid 
集成 、 打 包 部 署 、 定 时 任务 、 邮 件 发 送 。 


9.3.1 Spring Boot 集成 Druid 


Druid 是 阿里 巴巴 开源 平台 上 的 一 个 数据 库 连 接 池 实 现 , 结合 了 C3P0、DBCP、PROXOOL 
等 DB 池 的 优点 ， 同 时 加 入 了 日 志 监 控 ， 可 以 很 好 地 监控 DB 池 连 接 和 SQL 的 执行 情况 ， 可 
以 说 是 针对 监控 而 生 的 DB 连接 池 。 


1. 引入 依赖 


创建 SpringBootDruid 项 目 ， 在 项 目 中 实现 ISP 页 面 ， 显 示 通 过 MyBatis 从 MySQL 数据 
库 中 查询 出 来 的 数据 ， 具 体 实现 代码 就 不 贴 上 来 了 。 为 了 演示 Druid 的 使 用 ， 引 入 了 
druid-spring-boot-starter。 


<dependency> 
<groupId>com.alibaba</groupId> 
<artifactId>druid-spring-boot-starter</artifactId> 
<version>1.1.10</version> 

</dependency> 


2. 设置 Druid 属性 


spring.datasource.druid.type=com.alibaba.druid.pool.DruidDataSource 
spring.datasource.druid.max-active=20 
spring.datasource.druid.initial-size=1 
spring.datasource.druid.max-wait=60000 
spring.datasource.druid.pool-prepared-statements=true 
spring.datasource.druid.max-pool-prepared-statement-per-connection-size- 
20 
spring.datasource.druid.connection-properties-druid.stat.mergeSql-true;d 
ruid.stat.slowSglMillis-5000 
spring.datasource.druid.min-idle-1 
spring.datasource.druid.time-between-eviction-runs-millis-60000 
spring.datasource.druid.min-evictable-idle-time-millis-300000 
spring.datasource.druid.validation-query-select 1 from dual 
spring.datasource.druid.test-while-idle-true 
spring.datasource.druid.test-on-borrow-true 
spring.datasource.druid.test-on-return-true 


spring.datasource.druid.web-stat-filter.enabled-true 
spring.datasource.druid.web-stat-filter.url-pattern-/* 
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spring.datasource.druid.web-stat-filter.exclusions=*.js,*.gif,*.jpg,*.pn 
g,*.css,*.ico, /druid/* 

spring.datasource.druid.web-stat-filter.session-stat-enable=true 

spring.datasource.druid.web-stat-filter.session-stat-max-count=1000 


spring.datasource.druid.stat-view-servlet.enabled= true 
spring.datasource.druid.stat-view-servlet.url-pattern-/druid/* 
spring.datasource.druid.stat-view-servlet.reset-enable-true 
spring.datasource.druid.stat-view-servlet.login-username-druid 
spring.datasource.druid.stat-view-servlet.login-password-123456 
spring.datasource.druid.stat-view-servlet.allow-127.0.0.1 
spring.datasource.druid.stat-view-servlet.deny-192.168.0.19 


3. Druid 测试 


先 启动 应 用 ， 然 后 在 浏览 器 输入 “http:/127.0.0.1:8080/druid/index.html”， 就 会 显示 登录 
页 面 ， 输 入 上 面 配 置 的 密码 即 可 登录 ， 如 图 9-21 所 示 。 


127.0.0.1; 


Login 


in Reset 


图 9-21 


在 浏览 器 访问 Controller 中 的 方法 之 后 就 可 以 在 Druid 中 看 到 SQL 监控 记录 ， 如 图 9-22 
所 示 。 


SO wa D 127.00.1:80 


Druid Monitor 。 首页 mes sos SOLOS «= Web 应 用 URI 监控 Session 监 说 spring 监控 。 JSON API Ed 


SQL Stat View JSON API L 


执行 时 间 分 布 执行 +RS 时 分 布 
N SQLY 执行 数 执行 时 间 Be 事务 执行 HRR 更 新 行 数 。 c E 执行 中 最 大 并 发 [-------- ] [-------- ] 


1 SELECT* 1 210 210 1 1 {0.0.0,1,0,00,0] — [1,0,0,0,0.,0,0,0] 
FROM user 
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9.3.2 Spring Boot 定时 任务 


定时 任务 有 好 多 开源 框架 ， 比 如 Quartz. @Scheduled 是 Spring 的 一 个 定时 任务 注解 ， 通 
过 注解 配置 就 能 够 完成 轻 量 级 的 定时 任务 ， 简 单方 便 。@Scheduled 注解 主要 包含 cron、 
fixedRate、fixedDelay、initialDelay 属性 。 


(1) cron 属性 
这 是 一 个 时 间 表 达 式 ， 可 以 通过 简单 的 配置 完成 各 种 时 间 的 配置 。 我 们 通过 CRON 表达 
式 几 乎 可 以 完成 任意 的 时 间 搭 配 ， 它 包含 了 6 个 或 7 个 域 : 
e Seconds: 可 出 现 ", -*/" 四 个 字符 ， 有 效 范 围 为 0 一 59 的 整数 。 
e Minutes: 可 出 现 ",-*/" 四 个 字符 ， 有 效 范围 为 0 一 59 的 整数 。 
© Hours: TER", -*/" 四 个 字符 ， 有 效 范围 为 0~23 的 整数 。 
e DayofMonth: 可 出 现 ",-*/?LWC" 八 个 字符 ， 有 效 范围 为 0~31 的 整数 。 
© Month: 可 出 现 ",-*/" 四 个 字符 ， 有 效 范围 为 1~12 的 整数 或 JAN-DEc。 
© DayofWeek: 可 出 现 ", -*/?LC 四 个 字符 ， 有 效 范围 为 1~7 的 整数 或 SUN-SAT 两 个 
范围 。1 表示 星期 天 ，2 表示 星期 一 ， 以 此 类 推 。 
© Year: 可 出 现 ",-*/" 四 个 字符 ， 有 效 范围 为 1970~2099 年 。 
"0012** 2: 每 天 中 午 十 二 点 触发 。 
"015107**": 每 天 早上 10: 15 触发 。 
"01510**2" : 每 天 早上 10: 15 触发 。 
"01510**2*"; 每 天 早上 10: 15 触发 。 
"01510 * * 22005": 2005 年 的 每 天 早上 10: 15 触发 。 
"0*14** 2": 每 天 从 下 午 2 点 开始 到 2 点 59 分 每 分 钟 一 次 触发 。 
"00/5 14** m: 每 天 从 下 午 2 点 开始 到 2: 55 分 结束 每 5 分 钟 一 次 触发 。 
"00/5 14,18* * 9": 每 天 的 下 午 2 点 至 2: 55 和 6 点 至 6 点 55 分 两 个 时 间 段 内 每 5 分 
钟 一 次 触发 。 
> "00-514**2": 每 天 14:00 至 14:05 每 分 钟 一 次 触发 。 
> "010,4414?3 WED": 三 月 的 每 周三 的 14: 10 和 14: 44 触发 。 
> "015 10?* MON-FRI": 每 个 周一 、 周 二 、 周 三 、 周 四 、 周 五 的 10: 15 触发 。 


VVVVVVV V 


(2) fixedRate 属性 
EA FFP ae JE FER ON A ESE), ORS FFE BT 
的 问题 ， 所 以 不 建议 使 用 ， 但 数据 量 如果 不 大 时 在 配置 的 间隔 时 间 内 可 以 执行 完 也 是 可 以 使 
用 的 。 
(3) fixedDelay 属性 
该 属性 的 功效 与 上 面 的 fixedRate 是 相反 的 ， 配 置 了 该 属性 后 会 等 到 方法 执行 完成 后 延迟 
配置 的 时 间 再 次 执行 该 方法 。 
(4) initialDelay 属性 
该 属性 跟 上 面 的 fixedDelay、fixedRate 有 着 密切 的 关系 ,为 什么 这 么 说 呢 ? 该 属性 的 作用 
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是 第 一 次 执行 延迟 时 间 ， 只 是 做 延迟 的 设 定 ， 并 不 会 控制 其 他 逻辑 ， 所 以 要 配合 fixedDelay 
或 者 fixedRate 来 使 用 。 

这 里 创建 了 SpringBootScheduled 项 目 , 在 项 目 中 新 增 了 SchedulerTask 2$. f£ SchedulerTask 
类 中 定义 了 3 个 方法 来 测试 上 面 4 个 属性 的 使 用 。 


package com.example.demo; 

import java.text.SimpleDateFormat; 

import java.util.Date; 

import org.springframework.scheduling.annotation. Scheduled; 
import org.springframework.stereotype.Component; 


@Component 
public class SchedulerTask { 
SimpleDateFormat dateFormat = new SimpleDateFormat ("HH:mm:ss"); 


@Scheduled(fixedRate = 10000) 
public void timerRate() { 
System. out.print1n(dateFormat. format (new Date())); 


// 第 一 次 延迟 1 秒 执行 ， 当 执行 完 后 2 秒 再 执行 
@Scheduled(initialDelay = 1000, fixedDelay = 2000) 
public void timerInit() { 
System.out.println("init : "+dateFormat.format (new Date())); 


// 每 天 21 点 41 分 50 秒 执行 
@Scheduled(cron = "50 41 21 * * ?") 
public void timerCron() { 
System. out.println ("current time : "+dateFormat. format (new Date())); 


} 


最 后 还 需要 在 main 方法 类 中 设置 @EnableScheduling 来 开启 定时 任务 。 启 动 项 目 可 以 在 日 
志 中 看 到 打印 的 日 期 ， 如 图 9-23 所 示 。 


:08: 
1:09: 
2092 
109: 
209: 
709; 
209: 
209: 
209: 
209: 
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9.3.3 Spring Boot 集成 Swagger2 


Swagger 是 一 组 围绕 OpenAPI 规范 构建 的 开源 工具 , 可 帮助 设计 、 构 建 、 记 录 和 使 用 REST 
API. 简单 说 下 , 它 的 出 现 就 是 为 了 方便 进行 测试 后 台 的 restful 形式 的 接口 ,实现 动态 的 更 新 ， 
当 我 们 在 后 台 的 接口 修改 了 后 ，Swagger 可 以 实现 自动 更 新 ， 而 不 需要 人 为 地 维护 这 个 接口 进 
行 测试 。 

Swagger 通过 注解 表明 该 接口 会 生成 文档 ， 包 括 接口 名 、 请 求 方法 、 参 数 、 返 回信 息 等 ， 
下 面 几 个 是 Swagger 常用 注解 。 


e @Api: 修饰 整个 类 ， 描 述 Controller 的 作用 。 

© = @ApiOperation: 描述 一 个 类 的 一 个 方法 ， 或 者 说 一 个 接口 。 
© = @ApiParam: 单个 参数 描述 。 

e  (üApiModel: 用 对 象 来 接收 参数 。 

© @ApiProperty: 用 对 象 接收 参数 时 ， 描 述 对 象 的 一 个 字段 。 
e @ApiResponse: HTTP 响应 其 中 一 个 描述 。 

*  (üApiResponses: HTTP 响应 整体 描述 。 

© @Apilgnore: 使 用 该 注解 忽略 这 个 API。 

© (@ApiError : 发 生 错 误 返 回 的 信息 。 

* @ApiParamImplicitL: 一 个 请 求 参 数 。 

© @ApiParamsImplicit 多 个 请 求 参 数 。 


集成 Swagger 也 比较 简单 ,我 们 可 以 在 之 前 章节 demo 的 基础 上 做 修改 。 首 先 引 入 Swagger 
相关 依赖 。 


<dependency> 

<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger2</artifactId> 
<version>2.9.2</version> 

</dependency> 

<dependency> 
<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger-ui</artifactId> 
<version>2.9.2</version> 

</dependency> 


与 启动 类 同 级 包 建立 Swagger2。 


package com.example.demo; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import springfox.documentation.builders.ApiInfoBuilder; 

import springfox.documentation.builders.PathSelectors; 

import springfox.documentation.builders.RequestHandlerSelectors; 
import springfox.documentation.service.ApiInfo; 

import springfox.documentation.service.Contact; 
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import springfox.documentation.spi.DocumentationType; 
import springfox.documentation.spring.web.plugins.Docket; 
import springfox.documentation.swagger2.annotations.EnableSwagger2; 


@Configuration 
@EnableSwagger2 
public class Swagger2 { 
@Bean 
public Docket createRestApi() { 
return new Docket (DocumentationType.SWAGGER 2) 
.apiInfo(apiInfo()) 
-select () 
// 为 当前 包 路 径 
.apis (RequestHandlerSelectors.basePackage ("com.example.demo")) 
.paths (PathSelectors.any()) 
.build(); 


) 
// 构 建 api 文档 的 详细 信息 函数 , 注意 这 里 的 注解 引用 的 是 哪个 
private APiInfo apiInfo() { 

return new ApiInfoBuilder() 


// 页 面 标题 
.title("Spring Boot 测试 使 用 Swagger2 构建 RESTful API") 


// 创 建 人 

.contact (new Contact ("社会 主义 接班 人 "， 
"https://www.cnblogs.com/5ishare", "991843897@qq.com")) 

// 版 本 号 

.Version("1.0") 

// 描 述 

.description(" 用 户 管理 ") 

.build() 


} 


通过 @Configuration 注解 ， 表 明 它 是 一 个 配置 类 ，@EnableSwagger2 开启 swagger2。 

apiInfo() 配 置 一 些 基 本 的 信息 。apis() 指 定 扫 描 的 包 会 生成 文档 。 在 通过 createRestApi 函数 
创建 Docket 的 Bean 之 后 ，apiInfo0 用 来 创建 该 Api 的 基本 信息 (这 些 基 本 信息 会 展现 在 文档 
页 面 中 ) 。 

select() 函 数 返 回 一 个 ApiSelectorBuilder 实例 , 用 来 控制 哪些 接口 暴露 给 Swagger 来 展现 ， 
本 例 采 用 指定 扫描 的 包 路 径 来 定义 。Swagger 会 扫描 该 包 下 所 有 Controller 定义 的 API， 并 产 
生 文 档 内 容 (除了 被 @Apilgnore 指定 的 请 求 ) 。 

在 UserController 中 设置 接口 信息 。 
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@RestController 
GRequestMapping ("/user") 
public class UserController ( 


@Autowired 


private UserMapper userMapper; 
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@ApiOperation (value =" 查 询 所 有 用 户 ",notes ="",httpMethod = "GET") 


GGetMapping ("/user") 

public List<User> userList()( 
return userMapper.getAll(); 
} 


[** 

* 查询 用 户 根据 id 

* @return USer 对 象 
* @param id 

ef 


@ApiOperation (value 


"查询 用 户 ",notes 
"GET") 


@ApiImplicitParam (name "id",value = 


"String") 
@GetMapping ("/user/{id}") 
public User getUserById(@PathVariable 


User user 


userMapper.getOne (id) 
Return user; 

) 

/** 

* 新 增 User 

* @param user 

* @return success or error 

*/ 

GApiOperation(value = "新 增 用 户 ",notes 

@ApiImplicitParam (name 
dataType = "User") 


"user", value 
GPostMapping ("/user") 
public String createUser (@RequestBody 
int num 
if (num>0) { 
return 


userMapper. insert (user); 
"success"; 

H 
return "error"; 
} 

"E 

* 更 新 User 


"根据 用 户 id 查询 用 户 ",httPMethod = 


"用 户 id", required = true, dataType 


String id) { 


; 


- "",httpMethod - "POST") 
= "用户 实体 ", required = true, 


User user) { 
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* @param user 

* @return success or error 

*/ 

GApiOperation (value = "更 新 用 户 ",notes = "根据 用 户 id 更 新 用 户 ", httpMethod = 


"PUT") 


GApilmplicitParams(( 
@ApiImplicitParam(name = "id",value = "HP id", required = true, 
dataType = "String"), 
GApilmplicitParam(name = "user",value = "用 户 实体 , 传 入 更 改 后 的 数据 
",required = true,dataType = "User") 
}) 
GPutMapping ("user/{id}") 
public String updateUser(@PathVariable String id, @RequestBody User 
user) { 
int num = userMapper.update (user); 
if(num»0)( 
return "success"; 
} 


return "error"; 


[** 
* 删除 用 户 
* @param id 
* @return success or error 
Lt 
@ApiOperation(value = "删除 用 户 ",notes = "",httpMethod = "DELETE") 
GApilmplicitParam(name = "id",value = "用 户 id", required = true, dataType 
= "String") 
@DeleteMapping ("user/{id}") 
public String deleteUser (@PathVariable String id) { 
int num = userMapper.delete (id); 
if (num>0) { 
return "success"; 
} 


return "error"; 


) 


启动 类 设置 @MapperScan。@MapperScan("com.example.mapper") 最 后 启动 项 目 : 访问 
http://localhost:8080/swagger-ui.html， 如 图 9-24 所 示 。 
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9-24 
9.3.4 Spring Boot 打包 部 署 


正常 情况 下 ，Spring Boot 项 目 是 jar AMIE, JF HL Tomcat 服务 器 ， 所 以 每 次 重新 
启动 都 是 使 用 的 新 的 Tomcat 服务 器 。 正 因 如 此 ， 出 现 了 一 个 问题 : 上 传 到 项 目的 文件 ， 如 果 
是 保存 在 项 目 中 的 ， 那 么 重启 过 后 文件 就 会 丢失 。 比 如 我 们 上 传 了 一 个 头像 ， 重 启 项 目 后 ， 这 
个 头像 就 没 了 。 如 果 将 文件 保存 在 本 地 磁盘 中 ，HTML 中 的 标签 就 没有 办 法 获取 (当然 ， 企 
业 项 目 中 一 般 是 有 专门 的 图 片 服务 器 的 ) 。 因 此 ， 我 们 才 需 要 将 Spring Boot 项 目 打 成 war 包 ， 
放 到 Tomcat 中 去 运行 。 

Spring Boot 打 成 war 包 部 署 到 Tomcat 只 需 5 步 ， 这 里 以 上 一 节 的 SpringBootSwagger 项 
H 73 demo. 


C1) 修改 打包 形式 
在 pom.xml 里 设置 <packaging>war</packaging>。 


(2) ARRAS, Tomcat 插件 
在 pom.xml 里 找到 spring-boot-starter-web 依赖 节点 ， 在 其 中 添加 如 下 代码 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 
<exclusion> 
XgroupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-tomcat</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
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(3) 添加 servlet-api 的 依赖 
下 面 两 种 方式 都 可 以 ， 任 选 其 一 ， 这 里 使 用 的 是 第 一 种 。 


<dependency> 
XgroupId»javax.servlet«/groupId» 
<artifactId>javax.servlet-api</artifactId> 
<scope>provided</scope> 

</dependency> 

<dependency> 
XgroupId»org.apache.tomcat«/groupId» 
<artifactId>tomcat-servlet-api</artifactId> 
<version>8.0.36</version> 
<scope>provided</scope> 

</dependency> 


(4) 修改 启动 类 ， 并 重 写 初始 化 方法 
该 类 继承 了 SpringBootServletInitializer 并 且 重 写 了 configure 方法 。 
@SpringBootApplication 

@MapperScan ("com.example.mapper" 


public class SpringBootSwaggerApplication extends 
SpringBootServletInitializer{ 


@Override 
protected SpringApplicationBuilder configure (SpringApplicationBuilder 
builder) { 
return builder.sources (SpringBootSwaggerApplication.class) ; 


public static void main(String[] args) { 
SpringApplication. run(SpringBootSwaggerApplication.class, args); 


} 


(5) 打包 部 署 
在 项 目 根 目 录 (包含 pom.xml 的 目录 下 ) ， 在 命令 行 里 输入 “mvn clean package” 即 可 ， 
等 待 打包 完成 , 出 现 [INFO] BUILD SUCCESS 即 为 打包 成 功 。 然 后 把 target 目录 下 的 war 包 放 
到 tomcat 的 webapps 目录 下 ， 启 动 tomcat， 即 可 自动 解压 部 署 。 最 后 在 浏览 器 中 输入 
http://localhost:[ 端 口号 ]/[ 打 包 项 目 名 ]/， 如 图 9-25、 图 9-26、 图 9-27 所 示 。 


9-25 
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图 9-26 


localhost 


" ,"id":null,"age":0)] 


图 9-27 


小 结 


本 章 主 要 学 习 Spring Boot 的 应 用 ， 介 绍 了 Spring Boot 与 JSP、Redis、MyBatis、Druid、 
RabbitMQ、Swagger2 等 集成 的 用 法 ， 这 些 基 本 组 件 都 是 实际 项 目 中 常用 到 的 。 
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在 上 一 章 学 习 了 Spring Boot 的 具体 应 用 ， 在 本 章 我 们 将 了 解 一 下 Docker 容器 技术 。 


本 章 主要 涉及 的 知识 点 : 


镜像 : 镜像 的 创建 、 获 取 、 删 除 等 管理 。 
容器 : 容器 的 新 建 、 启 动 、 终 止 、 导 入 导出 。 
数据 管理 : 数据 卷 与 数据 容器 的 使 用 。 
端口 映射 与 容器 互联 : 端口 映射 、 容 器 互联 。 


1 0.1 Docker 基础 


各 大 公司 都 在 打造 自己 的 云 平台 , 包括 阿里 云 、 华 为 云 、 腾 讯 云 等 , 以 及 各 种 微服 务 架构 。 
其 实 ， 在 这 些 当中 Docker 容器 技术 算是 一 个 很 重要 的 角色 。 


10.1.1 Docker 介绍 


Docker 是 一 个 开源 的 应 用 容器 引擎 ， 基 于 Go 语言 并 遵从 Apache 2.0 协议 开源 。Docker 
可 以 让 开发 者 打包 他 们 的 应 用 以 及 依赖 包 到 一 个 轻 量 级 、 可 移植 的 容器 中 , 然后 发 布 到 任何 流 
行 的 Linux 机 器 上 , 也 可 以 实现 虚拟 化 。 容 器 完全 使 用 沙 箱 机 制 , 相互 之 间 不 会 有 任何 接口 (类 
似 iPhone 的 App) ， 更 重要 的 是 容器 性 能 开销 极 低 。 

Docker 的 应 用 场景 如 下 : 


Web 应 用 的 自动 化 打包 和 发 布 。 

自动 化 测试 和 持续 集成 、 发 布 。 

在 服务 型 环境 中 部 署 和 调整 数据 库 或 其 他 的 后 台 应 用 。 

从 头 编译 或 者 扩展 现 有 的 OpenShift 或 Cloud Foundry 平台 来 搭建 PaaS 环境 。 


(1) 简化 程序 

Docker 让 开发 者 可 以 打包 他 们 的 应 用 以 及 依赖 包 到 一 个 可 移植 的 容器 中 ， 然 后 发 布 到 任 
何 流行 的 Linux 机 器 上 ， 便 可 以 实现 虚拟 化 。Docker 改变 了 虚拟 化 的 方式 ， 使 开发 者 可 以 直 
接 将 自己 的 成 果 放 入 Docker 中 进行 管理 。 方 便 快 捷 已 经 是 Docker 的 最 大 优势 ， 过 去 需要 用 


#108 Docker A 


数 天 乃至 数 周 的 任务 ， 在 Docker 容器 的 处 理 下 ， 只 需要 数秒 就 能 完 


(2) 避免 选择 恐惧 症 

如 果 你 有 选择 恐惧 症 , 还 是 资深 患者 , 那么 可 以 用 Docker 帮 你 打包 你 的 纠结 , 比如 Docker 
BUR. Docker 镜像 中 包含 了 运行 环境 和 配置 ， 可 以 简化 部 署 多 种 应 用 实例 工作 ， 比 如 Web 应 
用 、 后 台 应 用 、 数 据 库 应 用 、 大 数据 应 用 《比如 Hadoop 集群 ) 、 消 息 队列 等 都 可 以 打包 成 一 
个 镜像 部 署 。 


(3) 节省 开支 

一 方面 ， 云 计算 时 代 到 来 ， 使 开发 者 不 必 为 了 追求 效果 而 配置 高 额 的 硬件 ，Docker 改变 
了 高 性 能 必然 高 价格 的 思维 定 势 。Docker 与 云 的 结合 ， 让 云 空间 得 到 更 充分 的 利用 。 不 仅 解 
决 了 硬件 管理 的 问题 ， 也 改变 了 虚拟 化 的 方式 。 


Docker 主要 有 三 大 核心 概念 : 镜像 、 容 器 、 仓 库 。 


© 镜像 : 在 安装 软件 操作 系统 的 时 候 可 能 会 用 到 镜像 。Docker 中 的 镜像 与 操作 系统 镜像 文 
件 类 似 ， 可 以 理解 成 一 个 模板 ， 有 点 类 似 手 机 App 应 用 。 

e 容器 : 容器 是 用 来 装 东西 的 ，Docker 中 的 容器 用 来 装 由 镜像 创建 的 应 用 运行 实例 。 这 个 
有 点 类 似 手 机 中 的 沙 金 ， 每 个 手机 App 都 用 自己 的 运行 环境 ， 不 受 其 他 App 的 影响 。 

© BE: 仓库 也 是 用 来 存放 东西 的 ， 是 静态 的 ， 存 放 的 是 镜像 文件 。 容 器 是 动态 的 ， 运 行 的 
是 镜像 。 这 个 有 点 类 似 App Store， 用 户 可 以 从 仓库 中 下 载 App 安装 到 手机 中 ， 手 机 中 每 
个 应 用 都 是 一 个 沙 金 环境 。 


10.1.2 Docker 在 Windows 下 的 安装 


1. 下 载 

在 下 载 之 前 首先 检查 一 下 自己 的 电脑 是 否 满足 Docker 的 要 求 : Window 系统 要 是 64 位 的 
Windows 10 专业 版 ， 同 时 Hyper-V AY. Hyper-V 的 状态 设置 可 以 是 不 启用 状态 。 如 果 是 没 
启用 ， 在 启动 Docker 时 会 有 提示 并 会 自动 重启 电脑 来 启用 。 下 载 之 后 就 是 安装 ， 一 步 一 步 地 
安装 。 

2. 启动 Docker 


在 启动 的 时 候 有 时 会 遇 到 如 图 10-1 所 示 的 内 存 不 够 用 的 提示 ， 可 以 释放 一 些 内 存 或 是 更 
PX Docker 设置 。 


Not enough memory to start Docker 


You are trying to start Docker but you don't have enough memory. 
Free some memory or change your settings. 


ok 


10-1 
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找到 Docker 的 setting， 在 设置 中 可 以 修改 分 配给 Docker 的 资源 ， 这 里 分 配 了 2 个 CPU. 
1280MB 的 内 存 ， 也 可 以 设置 共享 的 硬盘 驱动 ， 如 图 10-2 所 示 。 


General 


Advanced 
Shared Drives Limit the resources available to Docker 
Engine. 
‘Advanced 
Network PUR? 
—————— |} 
Proxies Memory: 1280 MB 
————i 
Daemon 
Swap: 1536 MB 
Kubernetes 一 一 一 一- 一 


Diskimage location 
Reset 


C:\Users\Public\Documents\Hyper-V\virtual Hard Disks\Mob | Browse 


Disk ima: size :48 GB (0 B. used) 


3. Docker 帮助 文档 


对 于 Docker 容器 算是 比较 新 的 技术 ， 帮 助 文档 可 以 直接 通过 命令 行 docker COMMAND 
--help 来 查看 每 个 命令 的 详细 介绍 ， 如 图 10-3 所 示 。 


图 10-3 


4. Docker 测试 


学 习 新 语言 一 般 都 是 从 hello world 开始 的 , Docker 也 一 样 , 可 以 通过 docker run hello-world 
来 测试 拉 取 一 个 image 从 Docker Hub 中 并 起 一 个 容器 container， 如 图 10-4 所 示 。 
图 10-4 也 有 对 docker run hello-world 命令 过 程 的 介绍 ， 对 应 内 容 如 下 。 
(1) Docker client 与 Docker Daemon 连接 。 
(2) Docker Daemon 从 Docker Hub 中 拉 取 一 个 hello-world 的 镜像 image。 
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(3) Docker 根据 镜像 image 来 创建 容器 container. 
(4) Docker Daemon 将 输入 发 给 Docker Client。 


E BIECAWINDOWS \system32\cmd.exe 


图 10-4 


Docker 镜像 


上 一 节 对 Docker 进行 了 简单 的 介绍 , 包括 Docker 的 三 大 核心 概念 , 本 节 主 要 介绍 Docker 
:大 核心 概念 中 的 镜像 。 
10.2.1 获取 镜像 
Docker 运行 容器 前 需要 本 地 存放 有 对 应 的 镜像 ， 如 果 镜 像 没 有 ， 会 从 默认 的 仓库 下 载 ， 
既然 是 默认 仓库 ， 那 肯定 是 公共 的 ， 当 然 也 可 以 自 定义 自 己 私 有 的 镜像 仓库 。 使 用 镜像 ， 首 先 
得 获取 镜像 ， 使 用 pull 来 拉 取 镜像 文件 到 本 地 。 我 们 可 以 使 用 docker pull --help 了 解 它 的 格式 
和 一 些 参数 说 明 ， 如 图 10-5 所 示 。 


图 10-5 


图 10-6 所 示 是 使 用 pull 来 获取 hello-world 镜像 ，tag 是 取 最 新 版 本 。 


图 10-6 
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10.22 ”查看 镜像 
对 于 本 地 安装 了 哪些 镜像 ， 可 以 使 用 docker images 来 查看 ， 如 图 10-7 所 示 。 


MB 


149MB 
<B 


3 10-7 
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8 
2. 
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docker images --help 命令 查看 , 如 图 10-8 所 示 。 


S pr 
) templat 


10.2.3 使 用 tag 添加 镜像 标签 
使 用 tag 可 以 给 镜像 添加 标签 ， 类 似 给 镜像 添加 一 个 别名 。 如 图 10-9 所 示 ， 首 先 使 用 命 


令 docker tag hello-world:latest myhello-world:latest 为 hello-world:latest 镜像 设置 标签 
myhello-world:latest。 设 置 之 后 使 用 docker images 查看 镜像 列表 ， 则 会 发 现 hello-world 和 


myhello-world 两 个 镜像 的 IMAGE ID 是 一 致 的 。 


图 10-9 


10.2.4 使 用 inspect 查看 详细 信息 


可 以 使 用 inspect 命令 查看 镜像 详细 信息 。 对 于 inspect 的 详细 使 用 ， 还 是 可 以 使 用 help 
来 查看 。 图 10-10 所 示 是 使 用 命令 docker inspect --help 来 查看 inspect 参数 的 详细 说 明 。 
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图 10-10 


这 里 使 用 docker inspect hello-world 来 查看 hello-world 镜像 的 详细 信息 ,如 图 10-11 所 示 。 


图 10-11 
10.2.5 使 用 history 查看 镜像 历史 记录 


使 用 docker history 查看 镜像 的 完整 记录 。 使 用 docker history hello-world 命令 来 查看 
hello-world 的 完整 记录 ， 如 图 10-12 所 示 。 


COMMENT 


图 10-12 


10.26 ”镜像 查找 


如 果 想 查找 某 个 镜像 ， 可 以 使 用 search 命令 查找 。 对 于 search 命令 的 使 用 , 可 以 使 用 help 
来 具体 了 解 ， 如 图 10-13 所 示 。 


图 10-13 


图 10-14 所 示 主 要 查找 stars>3 H name 包含 hello-world 的 镜像 。 
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图 10-14 
10.2.7 ”删除 镜像 
删除 镜像 使 用 rmi 命令 。 使 用 rmi 时 ， 通 过 标签 删除 镜像 时 ， 如 果 该 镜像 只 有 一 个 标签 ， 
那么 在 删除 标签 之 后 也 会 把 该 镜像 删除 ,如果 有 多 个 标签 ， 就 只 删除 对 应 的 标签 。 通 过 ID 删 
除 时 ,如 果 该 镜像 创建 的 容器 存在 时 镜像 文件 无 法 删除 , 就 会 尝试 删除 所 有 指向 该 镜像 的 标签 ， 
然后 删除 该 镜像 文件 本 身 ， 如 图 10-15 所 示 。 


rmi [OPTIONS] 


or more im 


图 10-15 
1. 使 用 标签 删除 镜像 
删除 myhello_world 的 镜像 ， 然 后 查看 镜像 列表 , 发 现 只 有 hello-world 了 , 如 图 10-16 所 示 。 


图 10-16 
2. 使 用 镜像 ID 删除 镜像 


从 图 10-17 可 以 看 到 ， 通 过 ID 删除 镜像 hello-world 时 ， 报 了 错误 ， 提 示 不 能 删除 ， 因 为 
这 个 镜像 fce289e99eb9 在 被 容器 使 用 ， 需 要 先 停 掉 容器 90e4296835b8。 


图 10-17 
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使 用 docker ps -a 查看 容器 , 发 现 会 有 一 个 容器 90e4296835b8 使 用 的 镜像 是 fce289e99eb9， 
如 图 10-18 所 示 。 


图 10-18 
10.2.8 创建 镜像 
创建 镜像 主要 有 两 种 方法 : 一 是 基于 已 有 镜像 的 容器 创建 ， 主 要 命令 为 commit， 二 是 基 
于 本 地 模板 导入 ， 主 要 命令 为 import。 
. 基于 已 有 镜像 的 容器 创建 


基于 已 有 镜像 的 容器 创建 ， 用 到 commit 命令 ， 首 先 使 用 help 了 解 commit 的 参数 信息 
如 图 10-19 所 示 。 


图 10-19 


以 hello-world 为 例 ， 使 用 docker commit -m "add a image" -a "cuiyw" 90e4296835b8 
cuiyw-hello-world 命令 ， 基 于 hello-world 镜像 的 容器 90e4296835b8 创建 了 一 个 新 的 镜像 
cuiyw-hello-world。 使 用 docker images 命令 查看 镜像 列表 时 即 可 发 现 新 的 cuiyw-hello-world 镜 
像 ， 如 图 10-20 所 示 。 


图 10-20 


2. 基于 本 地 模板 导入 


基于 本 地 模板 导入 用 到 import 命令 ,首先 还 是 使 用 heljp 了 解 import 的 参数 信息 ,如 图 10-21 
所 示 。 
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图 10-21 
既然 是 基于 本 地 模板 导入 ， 就 需要 先 有 本 地 模板 才 可 以 ， 所 以 还 需要 使 用 export 命令 导 


出 tar CFF. export 命令 是 对 容器 的 操作 ， 可 以 使 用 help 先 提前 了 解 一 下 ， 这 里 使 用 export 命 
4 SEF hello-world 的 镜像 容器 导出 ， 之 后 即 可 在 G 盘 目录 下 找到 hello-world.tar， 此 时 本 地 
模板 已 经 存在 ， 如 图 10-22 所 示 。 


:\Use nin>docke 


图 10-22 

最 后 使 用 docker import G:\hello-world.tar hello-world-import:latest 命 令 将 使 用 export 导 出 的 

文件 导入 并 设置 新 的 image 名 字 : hello-world-import:latest。 使 用 docker images 显示 镜像 列表 
时 可 以 看 到 新 的 image 已 经 存在 ， 如 图 10-23 所 示 。 


图 10-23 


10.29 ”另存 和 载 入 镜像 


镜像 也 可 以 以 文件 的 形式 存在 ， 可 以 将 镜像 另存 或 者 载 入 ， 主 要 用 到 两 个 命令 ， 一 个 是 另 
存 命令 save， 另 一 个 是 载 入 命令 load。 我 们 可 以 先 保存 (save) 一 个 镜像 ， 然 后 把 保存 的 镜像 
Wm Coad) 进来 。 首 先 使 用 docker save --help 来 查看 save 命令 的 使 用 方法 ， 可 以 从 图 10-24 
看 到 需要 传 两 个 参数 ， 一 个 是 -o 参数 ， 用 来 指定 导出 的 镜像 文件 路 径 ， 另 一 个 是 传 镜像 。 这 
里 还 是 以 hello-world 镜像 为 例 ， 先 使 用 save 命令 docker save -o G:\helloworld-save.tar 
hello-world 将 镜像 保存 到 G:\helloworld-save.tar 中 。 
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图 10-24 


将 hello-world 镜像 导出 之 后 可 以 使 用 load 镜像 导入 , 还 是 首先 使 用 help 了 解 load 命令 的 
使 用 方法 。 这 里 使 用 docker load -i G:\helloworld-save.tar 将 导出 的 hello-world 镜像 载 入 进来 ， 
如 图 10-25 所 示 。 


图 10-25 


Z3 
容器 
上 一 节 学 习 了 docker 容器 技术 三 大 概念 中 的 镜像 ， 本 节 来 学 习 docker 容器 技术 的 另 一 个 
WER: 容器 。 本 节 主要 了 解 容器 的 相关 操作 。 
10.3.1 新 建 与 启动 容器 


容器 类 似 一 个 手机 中 的 沙 盒 环 境 ， 用 来 运行 app 实例 。 和 镜像 一 样 也 是 对 容器 的 创建 、 删 
除 、 导 出 等 。 创 建 容器 可 以 使 用 create 命令 ， 首 先 还 是 使 用 help 了 解 一 下 create 命令 的 参数 ， 
如 图 10-26 所 示 。 


图 10-26 
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下 面 使 用 create 创建 容器 , 镜像 是 ubuntu, 返 回 容器 id。 通 过 ps 可 以 看 到 一 个 状态 是 created 
的 容器 ， 此 时 的 容器 并 没有 启动 ， 如 图 10-27 所 示 。 


图 10-27 


启动 容器 需要 使 用 start 命令 ， 还 是 可 以 使 用 help 来 了 解 一 下 start 的 使 用 ， 如 图 10-28 所 示 。 


图 10-28 
下 面 使 用 start 启动 ubuntu 容器 ， 然 后 使 用 docker ps -a 命令 查看 ubuntu， 可 以 发 现状 态 
为 Up， 如 图 10-29 所 示 。 


图 10-29 


除了 使 用 create. start 来 启动 容器 外 ， 还 可 以 使 用 run 命令 来 启动 容器 ， 如 图 10-30 所 示 。 


图 10-30 
然后 使 用 start 启动 , 其 实 也 可 以 直接 使 用 run 来 新 建 


上 面 是 先 使 用 create 创建 一 个 容器 
并 启动 容器 。 当 利用 docker run 来 创建 并 启动 容器 时 ，Docker 在 后 台 运 行 的 标准 操作 包括 : 

(1) 检查 本 地 是 否 存 在 指定 的 镜像 ， 不 存在 就 从 公有 仓库 下 载 。 

(2) 利用 镜像 创建 一 个 容器 ， 并 启动 。 

(3) 分 配 一 个 文件 系统 给 容器 ， 并 在 只 读 的 镜像 层 外 面 挂 载 一 层 可 读 写 层 。 
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(4) 从 宿主 主机 配置 的 网 桥接 口中 桥接 一 个 虚拟 接口 到 容器 中 。 
C5). 从 网 桥 的 地 址 池 配 置 一 个 IP 地 址 给 容器 。 

(6) 执行 用 户 指定 的 应 用 程序 。 

CD 执行 完毕 后 容器 自动 终止 。 


图 10-31 所 示 就 是 使 用 run 命令 来 启动 ubuntu。 


run -it ubuntu 


图 10-31 
10.3.2 ”守护 态 运行 
有 时 候 需 要 让 docker 容器 在 后 台 以 守护 态 形式 运行 ， 可 以 通过 -d 来 实现 。 如 图 10-32 所 
示 , 开启 一 个 ubuntu 容器 ， 启动 bin/sh 下 脚本 执行 后 面 的 脚本 语句 docker run -d ubuntu /bin/sh 
-c "while true;do echo hello world;sleep 10;done:"， 让 它 每 隔 10 毫秒 输出 一 个 “helloworld”， 
然后 通过 logs 来 查看 它 的 输出 ， 可 以 看 到 第 一 次 输出 了 两 个 ， 第 二 次 输出 了 三 个 。 
ep 10; done 


5a901d9c6d 


图 10-32 
10.3.3 终止 容器 


上 面 的 容器 一 直 在 后 台 运 行 ， 可 以 通过 ps 来 查看 它 的 状态 ， 如 图 10-33 所 示 。 


图 10-33 


如 果 想 终止 它 ， 可 以 使 用 stop。 图 10-34 所 示 是 stop 的 格式 和 参数 。 


图 10-34 
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使 用 stop 命令 终止 ubuntu 容器 之 后 ,使 用 docker ps -a 查看 ubuntu 容器 状态 , 已 变 成 Exited 
状态 ， 如 图 10-35 所 示 。 


:\Users\admin}docker stop 29c19cdi 


图 10-35 
10.3.4 进入 容器 
启动 容器 之 后 就 是 进入 容器 ， 对 容器 进行 操作 ， 包 括 attach 命令 和 exec 命令 。 
1. attach 命令 


学 习 attach 命令 还 是 从 help 命令 开始 ， 如 图 10-36 所 示 。 


图 10-36 


首先 启动 ubuntu， 然 后 使 用 attach 命令 进入 容器 。 之 后 使 用 echo 输出 abc， 如 图 10-37 所 
示 。 最 后 使 用 Ctrl+P 和 Ctrl+Q 组 合 键 退 出 。 


2. exec 命令 

首先 使 用 help 了 解 一 下 exec 的 使 用 ， 如 图 10-38 所 示 。 

然后 使 用 exec 命令 docker exec -it keen_golick bin/bash 进入 ubuntu 的 bin/bash F , 输出 abc， 
如 图 10-39 所 示 。 最 后 使 用 Ctrl+P 和 Ctrl+Q 组 合 键 退出 。 


242 


ontainer 


图 10-39 
10.3.5 容器 的 导入 导出 
镜像 有 导入 导出 , 容器 也 有 导入 导出 。 容 器 的 导入 导出 主要 涉及 两 个 命令 :export 和 import。 
1. 导出 
首先 还 是 使 用 help 了 解 一 下 export 的 使 用 ， 如 图 10-40 所 示 。 


图 10-40 


使 用 docker export -o G:\ubuntu.tar 44ce0074a613 命令 将 容器 44ce0074a613 导出 到 
G:\ubuntu.tar 中 ， 之 后 在 G 盘 目录 下 就 会 发 现 ubuntu.tar， 如 图 10-41 所 示 。 


E ubuntutar AR Sree 


图 10441 
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2. 导入 
导入 与 导出 是 相对 的 ， 上 面 介绍 了 导出 ， 下 面 介绍 一 下 导入 。import 的 用 法 如 图 10-42 所 示 。 


dmin>docker 


图 1042 


这 里 将 上 面 导 出 的 再 导入 进来 (docker import G:\ubuntu.tar import ubuntu) ， 如 图 10-43 


图 10-43 


load 是 导入 镜像 存储 文件 到 本 地 镜像 库 ，import 是 导入 一 个 容器 快照 到 本 地 镜像 库 。 区 别 


是 容器 快照 文件 将 丢弃 所 有 的 历史 记录 和 元 数据 信息 , 仅仅 保存 容器 当前 的 快照 状态 。 镜 像 文 
件 将 保存 完整 记录 ， 体 积 更 大 ， 容 器 快照 导入 时 可 以 重新 指定 标签 等 元 数据 信息 。 


搭建 私有 仓库 


本 节 学 习 一 下 仓库 ， 搭 建 一 个 本 地 私有 仓库 。 当 然 ， 也 可 以 使 用 远程 的 公有 仓库 ， 但 在 企 
业 中 有 的 还 是 放 在 本 地 ， 所 以 需要 搭建 私有 仓库 。 
1. 搭建 仓库 


可 以 在 容器 中 搭建 Cun) 一 个 仓库 镜像 ， 命 令 为 docker run -d -p 5000:5000 -v 
/opt/data/registry:/tmp/registry registry， 如 图 10-44 所 示 。 


图 10-44 
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2. 给 待 上 传 镜像 设置 tag 


给 busybox 设置 tag (docker tag busybox 127.0.0.1:5000/busyboxdocker) ， 然 后 可 以 看 到 
images 中 有 该 tag 的 image， 如 图 10-45 所 示 。 


图 10-45 
3. 上 传 到 仓库 


使 用 push 将 镜像 上 传 到 仓库 (docker push 127.0.0.1:5000/busyboxdocker) ， 如 图 10-46 所 示 。 


图 10-46 


数据 管理 


在 Docker 的 使 用 过 程 中 ， 需 要 对 数据 进行 持久 化 或 需要 在 多 个 容器 之 间 进行 数据 共享 ， 
就 会 涉及 容器 的 数据 管理 操作 。 主 要 有 两 种 方式 ， 一 是 数据 卷 ， 二 是 数据 卷 容器 。 
10.5.1 数据 卷 

数据 卷 是 一 个 可 供 容器 使 用 的 特殊 目录 , 将 主机 操作 系统 目录 直接 映射 进 容器 。 它 可 以 提 
供 很 多 特性 : 

CD 数据 卷 可 以 在 容器 之 间 共享 和 重用 ， 容 器 间 传 递 数据 将 变 得 高 效 方便 。 

(2) 对 数据 卷 内 数据 的 操作 会 立马 生效 ， 无 论 是 容器 内 还 是 本 地 操作 。 

(3) 对 数据 卷 的 更 新 不 会 影响 镜像 ， 解 耦 了 应 用 与 数据 。 

(4) 卷 一 直 存在 ， 直 到 没有 容器 使 用 ， 可 以 安全 地 外 载 它 。 

数据 卷 可 以 有 两 种 方式 存在 :一 是 挂 载 主机 目录 作为 数据 卷 ， 二 是 在 容器 内 创建 一 个 数 
据 卷 。 
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1. 挂 载 主机 目录 作为 数据 卷 


首先 在 G:\docker\test 目录 下 创建 两 个 文件 (1.txt 和 2log) ， 然 后 挂 载 主机 目录 到 数据 卷 
(docker run -d -it --name=test -v G:/docker/test:/test ubuntu /bin/sh) ， 如 图 10-47 所 示 。 


Æ > G(G) > docker > test 


est ubuntu / 


图 10-47 
然后 使 用 docker ps -a 命令 即 可 找到 上 面 运行 的 容器 ， 再 使 用 docker exec -it 75ae60cef308 
/bin/sh 命令 进入 容器 打开 bin/sh 目录 ， 会 发 现 有 一 个 test 的 文件 夹 。 打 开 test 文件 夹 ， 可 以 看 
到 有 上 面 的 两 个 文件 ， 如 图 10-48 所 示 。 


图 10-48 


最 后 在 1.txt 中 输入 内 容 ， 再 次 打开 可 以 看 到 容器 中 的 1.txt 也 更 新 了 ， 如 图 10-49 所 示 。 


图 10-49 
2. 在 容器 内 创建 一 个 数据 卷 
上 面 是 挂 载 主机 目录 作为 数据 卷 ， 其 实 也 可 以 在 容器 内 创建 一 个 数据 卷 ， 使 用 docker run 
-d -it --name=vtest -v /vtest ubuntu /bin/sh 命令 ， 创 建 了 ubuntu 镜像 的 容器 vtest， 并 在 容器 中 创 
建 了 一 个 名 为 vtest 的 数据 卷 ， 如 图 10-50 所 示 。 


图 10-50 


使 用 exec 命令 进入 容器 ， 可 以 发 现 定义 的 vtest 数据 卷 ， 如 图 10-51 所 示 。 
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图 10-51 


10.5.2 ”数据 卷 容 器 


如 果 容 器 之 间 需 要 共享 一 些 持续 更 新 的 数据 ,最 简单 的 方式 就 是 用 户 数据 卷 容 器 。 数 据 卷 
容器 就 是 一 种 普通 容器 ， 专 门 提供 数据 卷 供 其 他 容器 挂 载 使 用 。 

我 们 在 上 面 通 过 挂 载 主机 目录 作为 数据 卷 创建 了 test 容器 , 这 里 可 以 把 test 容器 作为 数据 
卷 容 器 ， 然 后 通过 下 面 的 命令 另外 创建 了 db1、db2 两 个 容器 ， 使 用 --volumes-from 参数 挂 载 
test 容器 中 的 数据 卷 。 


docker run -it --volumes-from test --name dbl ubuntu /bin/sh 


docker run -it --volumes-from test --name db2 ubuntu /bin/sh 

之 后 依次 使 用 exec 命令 打开 db1、db2 两 个 容器 , 在 两 个 容器 下 都 能 找到 test 目录 下 的 L.txt 
和 2.log 文件 ， 在 容器 db2 中 打开 1.txt 并 显示 其 内 容 ， 之 后 修改 1.txt 文件 的 内 容 ， 再 打开 容 
器 dbl 中 的 1.txt， 可 以 发 现 内 容 已 更 改 最 新 ， 如 图 10-52 所 示 。 


docker exec -it 0abd9b51c263 /bin/sh 
docker exec -it 4e76041f9861 /bin/sh 


图 10-52 


端口 映射 与 容器 互联 


在 搭建 私有 仓库 时 ,用 到 的 命令 为 docker run -d -p 5000:5000 -v /opt/data/registry:/tmp/registry 
registry， 其 中 “-p 5000:5000” 的 作用 就 是 用 来 进行 端口 映射 。 那 为 什么 需要 端口 映射 呢 ? 其 
实在 启动 容器 时 ， 如 果 不 配 置 宿主 机 器 与 虚拟 机 的 端口 映射 ， 外 部 程序 是 无 法 访问 虚拟 机 的 ， 
因为 没有 端口 ， 所 以 需要 进行 端口 映射 。 
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10.6.1 ”端口 映射 


端口 映射 有 两 个 关键 词 : -P All-p OLE 10-530 ,一 个 是 大 写 , 一 个 是 小 写 , 通过 run --help 
可 以 看 到 。 大 写 的 P 是 随机 映射 一 个 49000~49900 的 端口 到 内 部 容器 开放 的 网 络 端口 。 小写 p 
可 以 指定 要 映射 的 端口 ， 并 且 在 一 个 指定 端口 上 只 可 以 绑 定 一 个 容器 。 


图 10-53 
支持 的 格式 有 如 下 三 种 ， 比 较 常 用 的 是 第 三 种 ， 因 为 这 样 没 有 对 ip 进行 限制 ， 移 植 也 
方便 。 
(1) ip:hostPort:containerPort: 映射 指定 地 址 的 指定 端口 到 虚拟 机 的 指定 端口 〈 不 常用 ) ， 
如 127.0.0.1:5000:5000， 映 射 本 机 的 5000 端口 到 虚拟 机 的 5000 端口 。 
(2) ip::containerPort: 映射 指定 地 址 的 任意 端口 到 虚拟 机 的 指定 端口 〈 不 常用 ) ， 如 
127.0.0.1::5000， 映 射 本 机 的 5000 端口 到 虚拟 机 的 5000 端口 。 
(3) hostPort:containerPort: 映射 本 机 的 指定 端口 到 虚拟 机 的 指定 端口 (常用 )〉 ， 如 
5000:5000， 映 射 本 机 的 5000 端口 到 虚拟 机 的 5000 端口 。 


映射 完 之 后 我 们 可 以 通过 ps 来 查看 容器 的 映射 情况 ， 这 里 就 不 再 演示 了 。 其 实 也 可 以 使 
用 port 命令 来 查看 映射 情况 。 下 面 先 通过 help 来 查看 port 的 语法 和 格式 ， 然 后 查看 容器 
peaceful_lovelace 的 端口 映射 情况 ， 如 图 10-54 所 示 。 另 外 ， 可 以 多 次 使 用 -p 来 绑 定 多 个 端口 。 


图 10-54 
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在 实际 应 用 中 往往 需要 多 个 容器 交互 ， 比 如 一 个 数据 库容 器 来 提供 db 服务 ， 多 个 应 用 容 
器 来 部 署 应 用 ,使 用 端口 访问 就 会 暴露 端口 ， 这 样 不 太 安全 。 有 没有 方法 让 容器 互联 呢 ? 答案 
是 有 。 容 器 互联 的 方法 有 多 种 ， 这 里 主要 学 


2]link, fH link 是 只 针对 单 宿主 主机 的 。 


(1) 启动 mysql server 
首先 使 用 run 实例 了 一 个 mysql 数据 库 的 容器 ， 


容器 名 为 mysql，123 为 数据 库 的 root 
密码 。 


docker run --name mysql -e MYSQL ROOT PASSWORD-123 -d mysql 
(2) 使 用 --link 关联 


这 里 启动 一 个 webapp 的 容器 ， 关 联 mysql 容器 ， 并 取 别 名 为 db。webapp 容器 的 镜像 就 
是 普通 的 ubuntu 镜像 ， 如 图 10-55 所 示 。 


docker run --name webapp --link mysql:db -it -d ubuntu /bin/sh 


buntu /bin/sh 


图 10-55 


两 个 容器 互联 相当 于 在 它们 之 间 创 建 了 -个 虚拟 通道 , 而且 不 用 映射 它们 的 端口 到 宿主 主 
机 上 。 通 过 两 种 方式 为 -是 更 新 环境 变量 ， 二 是 更 新 /etc/hosts 文件 。 
我 们 可 以 进入 容器 webapp 来 查看 它 的 环境 变量 和 hosts 文件 。 可 以 在 hosts 中 找到 


172.17.0.6 db 40cb0c95f62d mysql 配置 信息 , 在 环境 变量 中 也 能 找到 MySQL 数据 库 的 相关 配 
置信 息 ， 如 图 10-56 所 示 。 


图 10-56 
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10.7 Dockerfile 


Dockerfile 是 一 个 包含 用 于 组 合 映像 的 命令 的 文本 文档 。 可 以 在 docker build 命令 中 使 用 -f 
标志 指向 文件 系统 中 任何 位 置 的 Dockerfile: docker build -f /path/to/a/Dockerfile. 

Docker 通过 读 取 Dockerfile 中 的 指令 自动 生成 映像 。 它 一 般 分 为 四 部 分 : 基础 镜像 信息 、 
维护 者 信息 、 镜 像 操 作 指令 和 容器 启动 时 执行 指令 ，““# ”为 Dockerfile 中 的 注释 。 在 这 四 部 
分 中 包含 若干 个 指令 ， 下 面 是 常用 指令 的 介绍 。 


(1) FROM 基础 镜像 信息 

指定 所 创建 镜像 的 基础 镜像 ， 必 须 指定 且 需 要 在 Dockerfile 其 他 指令 的 前 面 。 后续 的 指令 
都 依赖 于 该 指令 指定 的 image. FROM 指令 指定 的 基础 image 可 以 是 官方 远程 仓库 中 的 ， 也 可 
以 位 于 本 地 仓库 ， 格 式 为 FROM <image> 或 FROM <image>:<tag>。 


(2) MAINTAINER 指定 维护 者 信息 
用 于 将 image 的 制作 者 相关 的 信息 写 入 到 image 中 。 当 我 们 对 该 image 执行 docker inspect 
命令 时 ， 输 出 中 有 相应 的 字段 记录 该 信息 ， 格 式 为 MAINTAINER <name>. 


(3) RUN 运行 指定 命令 

格式 为 RUN<command> 或 RUN["executable","paraml","param2"]。 前 者 默认 在 shell 终端 
中 运行 命令 ， 即 /bin/sh -c; 后 者 则 使 用 exec 执行 ， 不 会 启动 shell 环境 ， 指 定 使 用 其 他 终端 类 
型 可 以 通过 第 二 种 方式 实现 ， 例 如 RUN ["/bin/bash","-c","each hello"]。 每 条 RUN 指令 将 在 当 
前 镜像 的 基础 上 执行 指定 命令 ， 并 提交 为 新 的 镜像 ， 当 命令 较 长 时 可 以 使 用 \ 来 换行 。 


(4) CMD 
用 于 container 启动 时 指定 的 操作 。 该 操作 可 以 是 执行 自 定义 脚本 ， 也 可 以 是 执行 系统 命 
令 。 该 指令 只 能 在 文件 中 存在 一 次 ， 如 果 有 多 个 ， 则 只 执行 最 后 一 条 。 格 式 为 
CMD["executable","paraml","param2"]。 使 用 exec 执 行 .CMD command paraml param2 在 /bin/sh 
中 执行 ,提供 给 需要 交互 的 应 用 。CMD ["param1","param2"] 提 供给 ENTRYPORT 的 默认 参数 。 


(5) ENTRYPOINT 

指定 容器 启动 时 执行 的 命令 ， 可 以 多 次 设置 ， 但 是 只 有 最 后 一 个 有 效 。 

ENTRYPOINT ["executable", "paraml", "param2"] (like an exec, the preferred 
form) 
ENTRYPOINT command paraml param2 (as a shell) 

该 指令 的 使 用 分 为 两 种 情况 ， 一 种 是 独自 使 用 ; 另 一 种 和 CMD 指令 配合 使 用 。 当 独自 使 
用 时 ， 如 果 你 还 使 用 了 CMD 命令 且 CMD 是 一 个 完整 的 可 执行 的 命令 ， 那 么 CMD 指令 和 
ENTRYPOINT 会 互相 覆盖 , 只 有 最 后 一 个 CMD 或 者 ENTRYPOINT 有 效 。 另 一 种 用 法 和 CMD 
指令 配合 使 用 来 指定 ENTRYPOINT 的 默认 参数 ,这 时 CMD 指令 不 是 一 个 完整 的 可 执行 命令 ， 
仅仅 是 参数 部 分 ENTRYPOINT 指令 只 能 使 用 ISON 方式 指定 执行 命令 ， 而 不 能 指定 参数 。 
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(6) LABEL 
给 镜像 添加 信息 。 格 式 为 LABEL <key>=<value>. 


(7) EXPOSE 

该 指令 会 将 容器 中 的 端口 映射 成 宿主 机 器 中 的 某 个 端口 。 当 你 需要 访问 容器 的 时 候 , 可 以 
不 使 用 容器 的 TP 地 址 而 是 使 用 宿主 机 器 的 IP 地 址 和 映射 后 的 端口 。 要 完成 整个 操作 ， 需 要 两 
个 步 又， 首先 在 Dockerfile 使 用 EXPOSE 设置 需要 映射 的 容器 端口 ， 然 后 在 运行 容器 的 时 候 
指定 -p 选项 加 上 EXPOSE 设置 的 端口 ,这样 EXPOSE 设置 的 端口 号 会 被 随机 映射 成 宿主 机 器 
中 的 一 个 端口 号 。 也 可 以 指定 需要 映射 到 宿主 机 器 的 那个 端口 , 这 时 要 确保 宿主 机 器 上 的 端口 
号 没有 被 使 用 。EXPOSE 指令 可 以 一 次 设置 多 个 端口 号 ， 相 应 的 运行 容器 的 时 候 ， 可 以 配套 
地 多 次 使 用 -p 选项 。 

(8) ENV 

指定 环境 变量 ， 格 式 为 ENV<key><value> 或 ENV <key>=<value>， 在 镜像 生成 过 程 中 会 
被 后 续 的 RUN 指令 使 用 ， 在 镜像 启动 的 容器 中 也 会 存在 。 也 可 以 通过 docker run --env 
key-value 设置 或 修改 环境 变量 。 假 如 你 安装 了 Java 程序 ， 需 要 设置 JAVA_HOME,， 那么 可 以 
在 Dockerfile 中 这 样 写 : ENV JAVA_HOME /path/to/java/dirent. 


(9) ADD 
所 有 复制 到 container 中 的 文件 和 文件 夹 权限 为 0755，uid 和 gid 3 0; 如 果 是 一 个 目录 ， 

那么 会 将 该 目录 下 的 所 有 文件 添加 到 container 中 ， 不 包括 目录 ; 如 果 文 件 是 可 识别 的 压缩 格 
式 ， 则 docker 会 帮忙 解压 缩 (注意 压缩 格式 ) ; 如 果 <src> 是 文件 且 <dest> 中 不 使 用 斜 杠 结束 ， 
则 会 将 <dest> 视 为 文件 , <src> 的 内 容 会 写 入 <dest>; 如 果 <src> 是 文件 且 <dest> 中 使 用 斜 杠 结束 ， 
则 会 将 <src> 文 件 复制 到 <dest> 目 录 下 。 格 式 为 ADD «src» <dest>。 其 中 ，<src> 是 相对 被 构建 
的 源 目录 的 相对 路 径 ， 可 以 是 文件 或 目录 的 路 径 ， 也 可 以 是 一 个 远程 的 文件 url; <dest> 是 
container 中 的 绝对 路 径 。 


(10) COPY 
复制 本 地 主机 的 sre C73 Dockerfile 所 在 目录 的 相对 路 径 、 文 件 或 目录 ) 下 的 内 容 到 镜像 
中 的 dest 下 ， 目 标 路 径 不 存在 时 会 自动 创建 ， 格 式 为 COPY «sre» <dest>。 


(11) VOLUME 

使 容器 中 的 一 个 目录 具有 持久 化 存储 数据 的 功能 , 该 目录 可 以 被 容器 本 身 使 用 , 也 可 以 共 
享 给 其 他 容器 使 用 。 我 们 知道 容器 使 用 的 是 AUFS， 这 种 文件 系统 不 能 持久 化 数据 ， 当 容器 关 
Hg. 所 有 的 更 改 都 会 丢失 。 当 容器 中 的 应 用 有 持久 化 数据 的 需求 时 可 以 在 Dockerfile 中 使 用 
该 指令 ,格式 为 VOLUME ["/data"]。 


(12) USER 
设置 启动 容器 的 用 户 ， 默 认 是 root 用 户 。 格 式 为 USER daemon。 当 服务 不 需要 管理 员 权 
限时 ， 可 以 通过 该 命令 指定 运行 用 户 。 
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(13) WORKDIR 
为 后 续 的 RUN CMD ENTRYPOINT 指定 配置 工作 目录 ， 格 式 为 WORKDIR 
/path/to/workdir. 


(14) ONBUILD 
配置 当 所 创建 的 镜像 作为 其 他 镜像 的 基础 镜像 时 所 执行 的 创建 操作 指令 ， 格 式 为 
ONBUILD [INSTRUCTION]。 


(15) ARG 
指定 一 些 镜像 内 使 用 的 参数 〈 例 如 版 本 号 信息 等 ) 。 这 些 参数 在 执行 docker build 命令 时 
以 --build-arg <varname>=<value> 格 式 传 入 。 格 式 为 ARG <name>[=default value]。 可 以 用 
docker build --build-arg <name>=<value> 来 指定 参数 值 。 


山名 “Docker 822 Tomcat 部 署 war 包 


前 面 几 节 介 绍 了 Docker 的 基础 知识 ， 本 节 是 前 面 章节 的 具体 应 用 ,在 Docker 容器 中 ,使 
用 Tomcat 部 署 war 包 主 要 包括 四 个 步 又， 即 创建 Tomcat 容器 、 上 传 war 包 到 容器 、 重 启 容 
器 、 访 问 应 用 。 

1. 创建 Tomcat 容器 

使 用 docker run -d --name cmdtomcat -p 8080:8080 tomcat 命令 启动 Tomcat 容器 ， 在 浏 
览 器 中 输入 http:Wlocalhost:8080/ 可 以 显示 tomcat 配置 页 面 。 使 用 docker ps -a 可 以 看 到 
cmdtomcat 的 容器 ， 如 图 10-57 所 示 。 


S localhost 


Home Documentation Configuration Examples Wiki 


Apache Tomcat/8.5.38 


Recommended Reading: 


图 10-57 


使 用 docker exec -it 6ba4ccc864bd /bin/bash 命令 交互 式 地 进入 Tomcat 容器 ， 可 以 看 到 
webapps 目录 以 及 webapps 目录 下 的 文件 ， 如 图 10-58 所 示 。 


2. 上 传 war 包 到 Tomcat 容器 


war 包 是 第 9 章 打 包 部 署 用 的 包 , 为 了 方便 演示 ,这 里 将 war 包 放 在 了 G:\dockerwar 目录 
Fo Docker 中 也 可 以 使 用 cp 命令 完成 和 宿主 机 的 文件 复制 ， 如 图 10-59 所 示 。 
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图 10-58 


Docker cp G:\dockerwar\SpringBootSwagger-0.0.1-SNAPSHOT.war 
cmdtomcat:/usr/local/tomcat/webapps 


图 10-59 
3. 重启 容器 


使 用 docker restart cmdtomcat 命令 重启 容器 ， 然 后 进入 容器 可 以 看 
SpringBootSwagger-0.0.1-SNAPSHOT.war 包 ， 如 图 10-60 所 示 。 


上 面 复制 进去 的 


min>docker restart 


trootü6b. 


ROOT 


图 10-60 
4. 访问 应 用 


在 浏览 器 中 输入 “http:/Wlocalhost:8080/SpringBootSwagger-0.0.1-SNAPSHOT/swagger- 
ui.html” 即 可 正常 显示 页 面 ， 如 图 10-61 所 示 。 


= Oo û localhost 


o 


Swagger2 fai 


REIS 


图 10-61 
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5. 以 挂 载 方式 启动 


上 述 执行 有 一 个 弊端 ,就 是 容器 重启 后 项 目 就 会 不 在 了 , 我 们 可 以 以 挂 载 的 方式 启动 ， 如 
图 10-62 所 示 。 


79c32077052e64ea6640c550d3 


图 10-62 


如 图 10-63 所 示 ， 进 入 cmdtomcat2 容器 ， 可 以 看 到 SpringBootSwagger-0.0.1- 
SNAPSHOT.war 已 在 webapps 目录 下 。 在 浏览 器 中 输入 “http:/localhost:8081/ 
SpringBootSwagger-0.0.1-SNAPSHOT/swagger-ui.htm1”， 也 是 正常 显示 页 面 。 


图 10-63 


小 结 


本 章 主要 学 习 了 Docker 的 基础 知识 ， 了 解 了 Docker 的 三 大 核心 概念 : 镜像 、 容 器 、 仓库 ， 
通过 使 用 Tomcat 部 署 war 演示 了 Docker 的 简单 使 用 。 如 果 对 Docker 感 兴趣 ， 后 续 还 可 以 学 
2] K8s. Docker Compose. 
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第 11 章 
< FRESIEXDRESISTRESECAX > 


前 面 几 章 学 习 了 Spring. MyBatis. Spring Boot 等 常用 的 相关 技术 ， 知 识 点 比较 分 散 ， 本 章 
通过 项 目 实战 来 对 前 面 几 个 章节 知识 点 进行 回顾 ， 同 时 也 方便 初学 者 了 解 实际 项 目 开发 流程 。 


本 章 主要 涉及 的 知识 点 : 

。 项 目 基础 : 需求 分 析 、RBAC 介绍 。 

© HARREM: 技术 方案 选 定 、 项 目 框架 搭建 。 

© ”项 目 技术 实现 : 数据 库 设计 、 功 能 点 详细 设计 和 具体 实现 。 
© = Shiro 框架 : 使 用 Shiro 实现 权限 管理 。 


项 目 基础 


在 软件 开发 过 程 中 ， 一 般 都 会 经 历 需 求 分 析 、 可 行 性 分 析 、 概 要 设计 、 详 细 设计 、 编 码 、 
测试 、 交 付 、 验 收 、 维 护 等 阶段 , 首先 要 了 解 项 目 基 本 信息 、 需 要 解决 哪些 问题 、 需 求 有 哪些 ， 
然后 对 需求 进行 可 行 性 研究 ， 再 根据 确定 的 需求 选用 合适 的 解决 方案 。 


11.1.1 项 目 介绍 


系统 一 般 由 多 个 模块 组 成 , 用 户 权 限 管理 算是 一 个 必 不 可 少 的 模块 , 而 且 不 管 是 什么 系统 


- 般 都 会 有 该 模块 。 用 户 权限 管理 是 使 有 


最 广 的 也 是 最 基础 、 最 重要 的 模块 。 不 良 的 权限 管理 


系统 ， 必 然 留 下 系统 漏洞 ， 给 黑客 可 趁 之 机 。 很 多 软件 可 以 轻松 通过 URL 侵入 、SQL 注入 等 
模式 ， 轻 松 越权 获得 未 授权 数据 ， 甚 至 对 系统 数据 进行 修改 、 删 除 ， 造 成 巨大 损失 。 

其 实 实现 该 项 目的 目的 不 仅 是 完成 用 户 权 限 管理 模块 , 而 是 在 过 程 中 了 解 软件 开发 流程 和 
设计 思想 , 起 到 抛砖引玉 的 作用 。 系 统 是 由 多 个 模块 组 成 的 ,熟悉 了 一 个 模块 的 开发 流程 ， 党 
握 了 软件 开发 设计 思想 ， 其 他 模块 也 是 按部就班 地 实现 。 


11.1.2 BRD 


以 公司 为 例 ， 一 个 公司 有 产品 、 开 发 、 运 维 之 分 ， 各 自负 责 各 自 的 业务 ， 相 互 独立 ， 又 相 
互 协 作 ， 共 同 完成 一 个 任务 ， 拥 有 不 同 权限 的 用 户 查 看 不 同 的 页 面 ， 进 行 不 同 的 操作 。 拥 有 不 
同 权限 的 用 户 查看 不 同 的 页 面 、 进 行 不 同 的 操作 ， 其 实 就 是 需求 ， 下 面 就 是 对 该 需求 的 分 析 。 
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首先 分 析 拥 有 不 同 权限 的 用 户 部 分 ,， 有 的 用 户 权限 很 少 ， 有 的 用 户 权限 很 多 , 而 且 用 户 的 
权限 也 会 发 生变 动 , 用 户 的 数量 也 会 发 生变 化 , 有 时 用 户 数 量 甚至 会 呈 几 何 级 增长 ， 如果 对 每 
个 用 户 都 专门 进行 权限 判断 , 那 对 系统 维护 和 权限 管理 都 带 有 很 大 挑战 。 拥有 不 同 权限 的 原因 
是 岗位 分 工 不 同 , 那 我 们 可 以 通过 岗位 来 控制 权限 ,不 同 岗 位 的 用 户 有 不 同 的 权限 ， 相 同 岗位 
的 用 户 有 相同 的 权限 ， 这 里 岗位 也 可 以 理解 成 角色 。 所 以 功能 权限 管理 技术 ,一般 就 使 用 基于 
角色 访问 控制 技术 (Role Based Access Control, RBAC) 。 

在 RBAC 中 , 权限 与 角色 相关 联 , 用 户 通过 成 为 适当 角色 的 成 员 而 得 到 这 些 角色 的 权限 。 
这 就 极 大 地 简化 了 权限 的 管理 。 这样 管 理 都 是 层级 相互 依赖 的 ， 权限 赋予 角色 ,而 把 角色 又 赋 
予 用 户 ， 这 样 的 权限 设计 很 清楚 ， 管 理 起 来 很 方便 。 该 技术 模型 如 图 11-1 所 示 。 


图 11-1 


然后 分 析 查 看 不 同 的 页 面 ,进行 不 同 的 操作 部 分 。 首 先 对 不 同 页 面 的 理解 , 要 和 弄 清楚 是 怎 
么 不 同 ， 比 如 有 的 用 户 对 一 些 页 面 完 全 不 能 访问 , 有 的 用 户 可 以 访问 , 不 同 用户 访 问 同一 页 面 


显示 的 数据 、 


内 容 不 同 。 其 次 是 不 同 的 操作 的 理解 ， 同 一 页 面 的 按钮 ， 有 的 用 户 可 以 点 击 ， 有 


的 用 户 无 法 点 击 ， 有 的 用 户 有 编辑 数据 的 权限 ， 有 的 用 户 没有 编辑 数据 的 权限 。 这 里 要 特别 提 
醒 一 下 ， 需 求 分 析 是 非常 重要 的 ， 调 研 需求 的 方法 也 多 种 多 样 ， 只 有 先 把 需求 理 清 、 明 确 ， 知 
道 要 解决 什么 问题 了 才 好 进行 后 续 的 设计 开发 工作 , 需求 不 明 也 是 好 多 项 目 延期 、 加 班 严 重 的 
一 个 重要 原因 。 


11.1.3 ”技术 选 型 
项 目 主要 使 用 LayUI 前 端 框架 和 Thymeleaf, 实现 前 后 端 分 离 , 后 端 主要 使 用 Spring Boot, 


Spring MVC 
Shiro。 


、MyBatis、PageHelper， 数 据 库 使 用 MySQL, 日 志 使 用 Log4j2， 权 限 管理 使 用 


对 于 前 端 框架 有 好 多 种 选择 : Bootstrap、EasyUI、KendoUI、LayUI 等 各 种 前 端 框 架 。 选 
择 哪 一 种 都 可 以 ， 这 里 选择 LayUI 框架 。 

后 端 几 个 技术 的 选择 ,主要 是 巩固 一 下 前 面 章节 的 知识 , 对 前 面 章 节 的 内 容 进行 复习 , 也 
是 目前 项 目 比较 常用 的 技术 。 

权限 管理 选择 的 是 Shiro 框架 ， 是 Java 的 一 个 安全 框架 。 目前 , 使 用 Apache Shiro 的 人 越 
来 越 多 ， 因 为 它 相 当 简 单 ， 对 比 Spring Security， 可 能 没有 Spring Security 做 的 功能 强大 ， 但 


是 在 实际 工人 


FE 时 可 能 并 不 需要 那么 复杂 的 东西 ， 所 以 使 用 小 而 简单 的 Shiro 就 足够 了 。 对 于 


Shiro 的 详细 介绍 ， 大 家 可 以 从 网 络 上 查看 。 
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11.2 项 目 实现 


前 面 对 项 目 进行 了 分 析 以 及 技术 选 型 ,本 节 就 进入 项 目 实现 部 分 。 首先, 需要 把 项 目 框 架 
搭建 起 来 。 


11.2.1 搭建 框架 
本 项 目的 架构 采用 分 层 思想 ， 主 要 包含 8 个 包 ， 如 图 11-2 所 示 。 


v $$ Manage [boot] 
v $9 src/main/java 
> B com.example 
由 com.example.config 
> §B com.example.controller 
v i com.example.dao 
> [ff UserMapperjava 
v & com.example.entity 
> B) UserSearchDTO java 
v &i com.example.pojo 
D) Userjava 
v 出 com.example.service 
> 国 UserServicejava 
v g com.example.service.impl 
GS UserServicelmpljava 
v f com.example.utils 
> [Jj] BaseControllerjava 
> [J] PageDataResultjava 
v (9^ src/main/resources 
v & mybatis 
v © mapper 
Xj UserMapper.xml 


X, mybatis-config.xml 


plates 
® application. properties 
国 logdj2xml 


FA 11-2 

下 面 对 这 几 个 包 进行 简单 介绍 。 

e com.example: 存在 main 函数 类 。 

e com.example.config: 配置 类 包 ， 例 如 druid 多 数据 源 配置 类 。 

*  com.example.controller: 存放 controller. 

e com.example.dao: 与 数据 库 交 互 层 ， 存 放 mapper 接口 。 

© com.example.entity: 实体 层 , 这 个 与 com.example.pojo 有 点 类 似 , 不 过 两 个 还 是 有 区 别 的 ， 
pojo 层 主要 是 与 数据 库 单个 数据 表 对 应 ，entity 可 能 是 其 他 对 象 的 抽象 ， 比 如 多 个 表 联 合 
查询 组 成 的 行 对 应 的 类 或 者 前 端 页 面 显示 对 应 的 类 、 一 对 多 、 多 对 多 关系 。 

e com.example.pojo: 数据 库 表 的 对 应 类 。 
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e  com.example.service: 业务 服务 接口 层 ， 定 义 服 务 接口 。 优 势 是 什么 呢 ? 这 样 在 Controller 
中 注入 的 是 service 接口 ， 是 面向 接口 的 编程 ， 如 果 服 务 的 具体 实现 改变 了 也 不 影响 其 他 
注入 类 。 

e  com.example.service.impl: 实现 服务 接口 ， 业 务 逻 辑 的 有 具体 实现 。 

e com.example.utils: 基础 类 、 工 具 类 层 。 


静态 文件 或 者 资源 文件 的 目录 结构 如 图 11-3 所 示 。 其 中 ，mybatis 目录 下 存放 mapper X 
fF. static 目录 中 存放 css. js 等 资源 文件 ，templates 中 存在 html 页 面 。 


v XS Manage [boot] 


$98 src/main/java 


v (9 src/main/resources 
v & mybatis 
v (E mapper 
|X) PermissionMapper.xml 
因 RoleMapper.xml 
四 UserMapper.xml 
四 mybatis-config.xml 
> © static 
> (css 
> © images 
> Bis 
> © layui 
v © templates 
> (9 permission 
> © role 
> & user 
E home.html 
E index html 
[Ej legin.html 
局 application.properties 
四 log4j2.xml 
> [9 src/test/java 


E 11-3 
11.2.2 ”数据 库 设 计 


基于 前 面 RBAC 的 分 析 ， 设 计 了 3 张 实体 表 (用 户 表 user、 角 色 role、 权 限 permission) 
和 2 张 关系 表 (用户 角 色 关 系 表 user_role、 角 色 权 限 关 系 role permission) 。 下 面 是 创建 几 张 
表 的 SQL 语句 。 


User 表 : 


CREATE TABLE “user” ( 
^name^ varchar(20) DEFAULT NULL, 
`age` int(11) DEFAULT NULL, 
^sex? tinyint(1) DEFAULT '0', 
^pwd? varchar(45) DEFAULT '123456', 
^id" varchar(45) NOT NULL, 
PRIMARY KEY (`id`) 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


258 


第 11 章 ”用户 权限 管理 项 目 实战 


Role 表 : 


CREATE TABLE ‘role’ ( 
`name` varchar(20) DEFAULT NULL, 
`desp` varchar(50) DEFAULT NULL, 
^id" varchar(20) NOT NULL, 
PRIMARY KEY ("^id") 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


Permission X: 


CREATE TABLE ^permission' ( 
^id? varchar(45) NOT NULL, 
^name^ varchar(45) DEFAULT NULL, 
^code^ varchar(45) DEFAULT NULL, 
^desp' varchar(45) DEFAULT NULL, 
`url` varchar(45) DEFAULT NULL, 
PRIMARY KEY ("id") 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


User Role X: 


CREATE TABLE "user role' ( 
^userid' varchar(45) NOT NULL, 
^roleid' varchar(45) NOT NULL, 
PRIMARY KEY (^userid', roleid') 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


Role Permission #: 


CREATE TABLE ^role permission" ( 
^roleid' varchar(45) NOT NULL, 
^permid? varchar(45) NOT NULL, 
PRIMARY KEY (^roleid', permid') 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


11.2.3 “前端 框架 引入 


前 端 选择 的 是 LayUI 框 架 ， 项 目 首页 采用 常见 的 左 侧 导 航 栏 ， 右 侧 上 部 是 tab 组 件 ， 下 部 
显示 内 容 ， 这 里 推荐 一 个 基于 开源 LayUI 的 插件 layTabPlus。 该 插件 是 一 个 layUI 后 台 Tab 布 
局 框架 的 扩展 插件 ， 实 现 了 Tab 管理 、 刷 新 按钮 、iframe 优化 等 功能 ， 非 常 好 用 。 引 入 方法 也 
比较 简单 。 


1. 下 载 插件 


需要 下 载 两 个 插件 : LayUI 插件 和 layTabPlus 插件 。layTabPlus 插件 的 下 载 地 址 为 
https://gitee.com/Leytton/layTabPlus。 两 个 插件 放 到 项 目的 资源 包 resources 下 ， 把 layTabPlus 
插件 中 的 index.html 页 面 内 容 放 到 templates 下 ,这 里 index.html 用 作 了 欢迎 页 面 ， 所 以 使 用 了 


home.html. 
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2. 引入 thymeleaf 模块 


新 建 项 目 时 选择 Web 和 thymeleaf 模块 ， 或 者 手动 在 项 目的 pomxml 中 引入 
spring-boot-starter-thymeleaf 来 自动 集成 thymeleaf. 


3. 创建 Controller 


在 com.example.Controller 包 下 创建 HomeController， 用 来 测试 home.html。 


package com.example.controller; 


import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 


@Controller 
GRequestMapping ("/home") 
public class HomeController { 
@RequestMapping (value = "/home",method = RequestMethod. GET) 
public String hello(Model model) { 
return "home"; 


} 
4. 测试 


启动 项 目 ， 在 浏览 器 中 输入 “http://localhost:8080/home/home”， 如 果 显 示 如 图 11-4 所 示 
的 页 面 ，LayUI 框架 就 引入 项 目 中 。 


eyremay Tatius 


€ 2018 lay Tantus - By Leyton 


图 11-4 
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124 用 户 角 色 增 删改 查 


1. 引入 依赖 


上 一 小 节 引 入 了 前 端 框架 LayUI 和 thymeleaf 实现 前 后 端 分 离 ， 这 里 实现 用 户 角色 增 、 删 、 
改 、 查 功能 , 需要 对 数据 库 操作 , 所 以 在 项 目 中 引入 了 mybatis-spring-boot-starter, mysql-connector- 
java， 并 引入 了 分 页 插件 pagehelper-spring-boot-starter 和 日 志 模块 spring-boot-starter-log4j2。 


<!-- https://mvnrepository.com/artifact/org.mybatis.spring.boot/ 
mybatis-spring-boot-starter --> 
<dependency> 


<groupId>org.mybatis.spring.boot</groupId> 
<artifactId>mybatis-spring-boot-starter</artifactId> 
<version>1.3.2</version> 

</dependency> 

<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java --> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>8.0.11</version> 


</dependency> 

<!-- https://mvnrepository.com/artifact/com.github.pagehelper/ 
pagehelper-spring-boot-starter --> 

<dependency> 


<groupId>com.github.pagehelper</groupId> 
<artifactId>pagehelper-spring-boot-starter</artifactId> 
<version>1.2.10</version> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-log4j2</artifactId> 
</dependency> 


集成 log4j2 后 可 以 在 application.properties 中 设置 log4j2 的 相关 配置 或 者 创建 log4j2.xml 
后 放 在 application.properties 目录 下 。 这 里 在 创建 的 log4j2.xml 中 设置 日 志 存 放 位 置 为 
D:\log\logs。 在 该 目录 下 的 日 志文 件 如 图 11-5 所 示 。 


软件 (D) > log > logs 


名 称 修改 日 期 类 型 大 小 
2019-02 2019/2/26 0:08 xe 
E] manage-error.log 2019/2/26 0:13 文本 39 KB 
国 manage-info.log 2019/2/26 0:42 AH 74 KB 
E] manage-warn.log 2019/2/25 23:43 文本 文档 17 KB 
11-5 
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在 引入 log4j2 时 还 需要 将 Spring Boot 默认 的 日 志 模 块 排除 , 需要 在 spring-boot-starter-web 
中 增加 exclusions 子 元 素 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 
<exclusion> 
<artifactId>spring-boot-starter-logging</artifactId> 
XgroupId»org.springframework.boot«/groupId» 
</exclusion> 
</exclusions> 
</dependency> 


2. 单 表 增 / 删 / 改 / 查 


在 用 户 管理 页 面 ， 实 现 了 用 户 的 增加 、 删 除 、 修 改 、 查 询 和 批量 删除 ， 首 先是 定义 实体 类 
(在 POJO 层 定 义 User 实体 类 ) 。 


package com.example.pojo; 
import java.io.Serializable; 
import java.util.List; 


public class User implements Serializable{ 


private static final long serialVersionUID = 1L; 
private String id; 

private String name; 

private Integer age; 

private String pwd; 

private String sex; 

private List<Role> roles; 


public String getId() { 
return id; 

} 

public void setId(String id) { 
this.id = id; 

H 

public String getName() ( 
return name; 

) 

public void setName(String name) ( 
this.name - name; 

} 

Public Integer getAge() { 
return age; 
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public void setAge(Integer age) { 
this.age = age; 

H 

public String getPwd() ( 
return pwd; 

H 

public void setPwd(String pwd) ( 
this.pwd - pwd; 


public List<Role> getRoles() ( 
return roles; 
H 
public void setRoles(List«Role» roles) ( 
this.roles - roles; 
H 
GOverride 
public String toString() ( 
return "User [id=" + id + ", name=" + name + ", age-" + age +", pwd=" 
+ pwd + ", sex=" + sex + ", roles-" 
+ roles + "]"; 
} 
public String getSex() { 
return sex; 
} 
public void setSex(String sex) { 
this.sex = sex; 


} 
然后 是 在 DAO 层 定义 与 数据 库 交 互 接口 UserMapper， 在 接口 中 声明 访问 数据 库 的 方法 。 


package com.example.dao; 


import java.util.List; 

import java.util.Map; 

import org.apache.ibatis.annotations.Mapper; 
import com.example.entity.UserSearchDTO; 
import com.example.pojo.User; 


@Mapper 
public interface UserMapper { 


[** 
* 分 页 查询 用 户 数据 


* @return 
a7 
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List<User> getUsers (UserSearchDTO userSearch) ; 
User queryById(String id); 

int editUser(User user); 

int insertUser(User user); 

int delUser(String[] ids); 

int delRoles (Map<String,Object> map); 

int addRoles (Map<String,Object> map); 


User getUserById(String id); 
} 


项 目 使 用 基于 xml 的 mybatis 来 操作 数据 库 ， 上 面 定 义 了 接口 之 后 ， 还 需要 在 resource 下 


的 mybatis 目录 下 创建 sql 映射 文件 UserMapper.xml， 映 射 文件 已 经 存在 ， 但 项 目 还 不 知道 数 
据 库 地 址 、sql 映射 文件 位 置 等 信息 ， 所 以 还 需要 在 application.properties 中 设置 数据 库 信息 和 
sql 映射 文件 位 置 等 信息 。 


#mysql 

spring.datasource.driverClassName = com.mysql.cj.jdbc.Driver 
#spring.datasource.url = jdbc:mysql://localhost:3306/mybatis 
spring.datasource.url -jdbc:mysql://127.0.0.1:3306/mybatis?useUnicode- 


true&characterEncoding-UTF-8&serverTimezone-UTC 


spring.datasource.username - root 
123456 


spring.datasource.password 
#mybatis 
mybatis.type-aliases-package-com.example.pojo 
mybatis.config-location-classpath:mybatis/mybatis-config.xml 
mybatis.mapper-locations-classpath:mybatis/mapper/*.xml 


访问 层 配置 完 之 后 ， 配 置 服务 层 。 在 service 接口 层 定义 接口 ， 然 后 在 service. impl 层 实现 


该 接口 。 下 面 的 代码 是 service 接口 层 代码 ， 具 体 实现 层 代码 可 以 查看 项 目 代码 。 
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package com.example.service; 
import org.springframework.stereotype.Service; 


import com.example.entity.UserSearchDTO; 
import com.example.pojo.User; 
import com.example.utils.PageDataResult; 


@Service 
public interface UserService { 
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public PageDataResult getUsers (UserSearchDTO userSearch) ; 
public User queryById(String id); 

public Boolean editUser(User user); 

public Boolean insertUser(User user); 

public Boolean delUser(String id) throws Exception; 
public Boolean delRoles(String userId,String roleIds); 
public Boolean addRoles(String userId,String roleIds); 


public User getUserById(String id); 
H 


服务 层 配 置 完 之 后 就 可 以 在 Controller 中 注入 服务 层 的 service， 调 用 服务 层 的 方法 了 。 用 
户 操作 页 面 发 送 请 求 调用 Controller 中 的 方法 。 
3. 分 页 


layui 的 table 填充 的 数据 有 4 个 字段 ， 即 code、msg、count、data， 所 以 在 PageDataResult 
中 也 定义 了 4 个 属性 。 


Package com.example.utils; 

import java.util.List; 

public class PageDataResult { 
// 总 记录 数量 
private Integer totals; 
// 当 前 页 数据 列表 
private List<?> list; 
private Integer code=200; 
private String msg=""; 
public String getMsg() { 


return msg; 


public void setMsg(String msg) { 
this.msg = msg; 


public PageDataResult() { 
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public PageDataResult( Integer totals, 
List<?> list) { 
this.totals = totals; 
this.list = list; 


public Integer getTotals() { 
return totals; 


public void setTotals(Integer totals) { 
this.totals = totals; 


public List<?> getList() { 
return list; 


public void setList(List«?» list) { 
this.list - list; 


public Integer getCode() ( 
return code; 


public void setCode(Integer code) ( 
this.code - code; 


GOverride public String toString() ( 
return "PageDataResult(" + "totals-" + totals + ", list-" + list 
+", code=" + code + '}'; 


} 
使 用 pagehelper 插件 分 页 之 后 的 数据 拼装 成 PageDataResult 对 象 返回 前 端 页 面 。 


@Override 
public PageDataResult getUsers(UserSearchDTO userSearch) { 


PageDataResult pdr = new PageDataResult (); 

PageHelper. start Page (userSearch.getPage(), 
userSearch.getLimit (), true); 

List<User> urList = userMapper.getUsers (userSearch) ; 
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logger.debug ("urList:"+urList.size()); 

// 获取 分 页 查询 后 的 数据 

PageInfo<User> pageInfo = new PageInfo<>(urList) ; 

// 设置 获取 到 的 总 记录 数 total: 

logger.debug ("page:"+tuserSearch.getPage()+"limit:"+ 
userSearch.getLimit ()*" TEL: "*pageInfo.getTotal()); 

pdr.setTotals (Long.valueOf(pageInfo.getTotal()).intValue()); 

pdr.setList (urList) ; 

return pdr; 


} 


由 于 与 LayUI 的 table 模块 要 求 的 数据 字段 名 不 一 致 ， 可 以 使 用 response 属性 配置 ， 而 且 
列表 性 别 列 中 ， 数 据 返 回 的 是 0、1， 为 了 得 到 更 好 的 用 户 体验 ， 使 用 templet 属性 将 1 显示 为 
男 、0 显示 为 女 。 


layui.use([ 'layer', 'table', 'element' ], function() { 
table = layui.table; 
layer = layui.layer; 
// 执行 一 个 table 实例 
table.render(( 
elem : '#user', 
height:350, 
url : '/user/getUsers', 
method: 'get', //BRU: get 请 求 
page :true, // 开启 分 页 
request: ( 
pageName: 'page' // 页 码 的 参数 名 称 ， 默 认 : page 
,limitName: 'limit' // 每 页 数据 量 的 参数 名 ， 默 认 : limit 
}, response: { 
statusName: 'code' // 数 据 状态 的 字段 名 称 ， 默 认 : code 
,StatusCode: 200 // 成 功 的 状态 码 ， 默 认 : 0 
,countName: 'totals' // 数 据 总 数 的 字段 名 称 ， 默认 : count 
,dataName: 'list' // 数 据 列表 的 字段 名 称 ， 默 认 : data 
kw 
cols : [ [ // XX 
{ 
fixed : 'left', 
type : 'checkbox' 
ht 
field : 'id', 
title : "编号 '， 
width : 80 


field : 'name', 
title : "姓名 '， 
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width : 80 


field : 'age', 
title : ' 年 龄 '， 
width : 80 


field : "sex", 
title : "性 别 '， 
width : 80, 
templet : function(d) { 
if (d.sex == 1) { 
return ' 男 '; 
} else if (d.sex == 0) { 
return ' 女 '; 
} 
} 
} 4 


title : "操作 '， 
width : 200, 
align : 'center', 
toolbar : '#tools' 


} 1] 


ne 
4. 主子 表 维 护 


对 User 表 的 操作 属于 单 表 操作 ,实现 了 User 单 表 操作 之 后 角色 Role 表 、 权 限 Permission 
表 的 增删 改 查 操 作 可 以 参考 用 户 User 表 实 现 。 项 目 中 常见 的 不 仅 有 单 表 操作 ， 还 有 主子 表 操 
作 。 用 户 和 角色 有 一 个 关系 表 user. role 表 ， 对 主子 表 的 维护 其 实 也 是 对 关系 表 的 操作 。 

用 户 在 用 户 表 中 点 击 “ 选 择 角色 ”〈 见 图 11-6) ， 弹 出 弹 窗 显示 已 有 的 角色 ， 点 击 “ 添 
加 角色 ”时 , 在 弹 窗 上 面 再 弹出 一 个 窗 体 显示 用 户 未 关联 的 角色 。 用 户 可 以 选择 角色 , 点 击 “ 添 
加 ”按钮 〈 见 图 11-7) 之 后 ， 在 顶部 弹 窗 会 将 选中 的 角色 去 除 ， 选 择 完毕 关闭 顶部 弹 窗 时 会 
刷新 底部 弹 窗 ， 显 示 用 户 的 角色 ， 同 时 用 户 可 以 对 关联 角色 进行 删除 ， 具体 实现 可 以 参考 项 目 
代码 。 


5. 事务 处 理 


主子 表 带 来 一 个 问题 ,就 是 当 删 除 主 表 数 据 时 需要 把 子 表 关联 的 数据 也 删除 ， 比 如 用 户 页 
面 ， 删 除 用 户 就 需要 把 用 户 与 角色 关联 表 中 相应 的 用 户 数据 也 删除 。 在 Spring Boot 处 理事 务 ， 
只 需要 在 main 方法 类 中 开启 全 局 事务 ， 然 后 在 对 应 的 类 或 方法 上 声明 事务 即 可 。 
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图 11-6 


Tow RIS weer 


图 11-7 
(1) 开启 事务 
在 main 方法 类 中 使 用 @EnableTransactionManagement 注解 开启 事务 。 


GComponentScan(basePackages = {"com.example.*"}) 
@SpringBootApplication 
@EnableTransactionManagement 

public class ManageApplication { 


public static void main(String[] args) { 
SpringApplication. run(ManageApplication.class, args); 
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(2) 在 类 或 方法 上 声明 事务 
使 用 @Transactional 注解 在 类 、 方 法 上 声明 事务 。 删 除 用 户 的 时 候 需 要 删除 关联 表 中 的 角 


色 信 息 ， 在 删除 用 户 的 方法 上 声明 了 事务 ， 为 了 测试 事务 ， 在 删除 关联 表 时 抛 出 了 
RuntimeException 异常 。 用户 编号 001 的 用 户 关联 的 是 有 角色 的 ,在 点 击 “ 删 除 ”时 会 报 “ 删 
除 失败 ! ”， 如 图 11-8、 图 11-9 所 示 。 
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@Override 
@Transactional (propagation=Propagation. REQUIRED) 
public Boolean delUser (String id) throws Exception { 
String[] ids=id.split(","); 
if (ids.length>0) 
{ 
userMapper .delUser (ids); 
for(int i=0;i<ids.length;i++) 
{ 
delRoles (ids[i],""); 
throw new RuntimeException ("ikfÉ"); 


return true; 
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11.2.5 Shiro 用 户 权 限 管 理 


用 户 权 限 管理 一 般 是 对 用 户 页 面 、 按 钮 的 访问 权限 管理 。 本 小 节 主 要 介绍 Shiro 的 简单 
使 用 。 


1. 引入 依赖 


使 用 Spring Boot 集成 Shiro 时 ， 在 pom.xml 中 可 以 引入 shiro-spring-boot-web-starter。 这 
里 使 用 的 是 Thymeleaf 框架 ，Thymeleaf 与 Shiro 结合 需要 引入 thymeleaf-extras-shiro。 


<!-- https://mvnrepository.com/artifact/org.apache.shiro/ 
shiro-spring-boot-web-starter --> 
<dependency> 
<groupId>org. apache. shiro</groupId> 
<artifactId>shiro-spring-boot-web-starter</artifactId> 
<version>1.4.0</version> 
</dependency> 
<!-- https://mvnrepository.com/artifact/ 
com.github.theborakompanioni/thymeleaf-extras-shiro --> 
<dependency> 
<groupId>com.github.theborakompanioni</groupId> 
<artifactId>thymeleaf-extras-shiro</artifactId> 
<version>2.0.0</version> 
</dependency> 


2. 增加 Shiro 配置 


有 哪些 url 是 需要 拦截 的 、 哪 些 是 不 需要 拦截 的 以 及 登录 页 面 、 登 录 成 功 页 面 的 url、 自 定 
义 的 Realm 等 这 些 信息 需要 设置 到 Shiro 中 ， 所 以 创建 Configuration 文件 ShiroConfig。 其 中 ， 
ShiroDialect bean 对 象 是 在 Thymeleaf 与 Shiro 结合 、 前 端 HTML 访问 Shiro 时 使 用 的 。 


@Configuration 
public class ShiroConfig { 
@Bean ("shiroFilterFactoryBean") 
public ShiroFilterFactoryBean shiroFilterFactoryBean (SecurityManager 
securityManager) { 
System. out.println("ShiroConfiguration.shirFilter()"); 
ShiroFilterFactoryBean shiroFilterFactoryBean = new 
ShiroFilterFactoryBean(); 
shiroFilterFactoryBean.setSecurityManager (securityManager); 
// 拦 截 器 . 
Map<String, String> filterChainDefinitionMap = new LinkedHashMap 
<String, String>(); 
// 配置 不 会 被 拦截 的 链接 顺序 判断 
filterChainDefinitionMap.put ("/static/**", "anon"); 
// 配 置 退出 过 滤器 , 其 中 的 具体 退出 代码 Shiro 已 经 蔡 我 们 实现 了 
filterChainDefinitionMap.put("/logout", "logout"); 
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//«i-- 过 滤 链 定义 ， 从 上 向 下 顺序 执行 ， 一 般 将 /** 放 在 最 为 下 边 -->: 这 是 一 个 坑 呢 ， 
一 不 小 心 代码 就 不 好 使 了 ; 
//<!-- authc: 所 有 url 都 必须 认证 通过 才 可 以 访问 ; anon: ATA url 都 可 以 匿名 访问 


=s% 
filterChainDefinitionMap.put("/**", "authc"); 
// 如 果 不 设置 默认 会 自动 寻找 web 工程 根 目录 下 的 "/1ogin.jsp" 页 面 
shiroFilterFactoryBean.setLoginUrl ("/login") ; 
// 登录 成 功 后 要 跳 转 的 链接 
shiroFilterFactoryBean.setSuccessUrl ("/index") ; 


// 未 授权 界面 ; 

shiroFilterFactoryBean.setUnauthorizedUrl ("/403"); 

shiroFilterFactoryBean.setFilterChainDefinitionMap 
(filterChainDefinitionMap) ; 

return shiroFilterFactoryBean; 


) 


// 创 建 defaultWebSecurityManager 
@Bean (name="defaultWebSecurityManager") 
public DefaultWebSecurityManager getDefaultWebSecurityManager 
(@Qualifier ("userRealm")MyShiroRealm userRealm) { 
DefaultWebSecurityManager defaultWebSecurityManager = new 
DefaultWebSecurityManager () ; 
defaultWebSecurityManager.setRealm(userRealm) ; 
return defaultWebSecurityManager; 


} 
// ti} Realm 


@Bean (name="userRealm") 
public MyShiroRealm getUserRealm() { 
return new MyShiroRealm(); 


GBean 
public ShiroDialect shiroDialect() ( 
return new ShiroDialect(); 
H 
) 


3. 自 定义 Realm 


在 自 定义 的 Realm 中 继承 了 AuthorizingRealm 抽象 类 ， 重 写 了 两 个 方法 : 
doGetAuthorizationInfo 和 doGetAuthenticationInfo. doGetAuthorizationInfo 主要 用 来 处 理 权 限 
配置 ，doGetAuthenticationInfo 主要 处 理 身份 认证 。 在 doGetAuthorizationInfo 中 ， 将 role 表 的 
id 和 permission 表 的 code 分 别 设置 到 SimpleAuthorizationInfo 对 象 中 的 role 和 permission 中 。 
最 后 需要 在 自 定 义 的 realm 上 添加 @Component("authorizer")， 和 否则 会 报错 ， 提 示 需 要 一 个 


authorizer 的 bean. 
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@Component ("authorizer") 
public class MyShiroRealm extends AuthorizingRealm { 


@Autowired 
private UserService userService; 


@Autowired 


private RoleService roleService; 


GOverride 
protected AuthorizationInfo doGetAuthorizationInfo (PrincipalCollection 
principals) ( 
System. out.println ("权限 配置 -->MyShiroRealm. 
doGetAuthorizationInfo()"); 
SimpleAuthorizationInfo authorizationInfo = new 
SimpleAuthorizationInfo(); 
User user = (User)principals.getPrimaryPrincipal (); 


System. out.printin("User:"+user.toString()+" roles count:"+ 
user.getRoles().size()); 


for (Role role:user.getRoles()) { 
authorizationInfo.addRole(role.getId()); 
role=roleService.getRoleById(role.getId()); 
System. out.println("Role:"+role.toString()); 
for (Permission p:role.getPermissions()) { 
System. out.println("Permission:"+p.toString()); 
authorizationInfo.addStringPermission (p.getCode()); 


} 

System. out.print1n ("权限 配置 -->authorizationInfo"+ 
authorizationInfo.toString()); 

return authorizationInfo; 


} 
/* 主 要 是 用 来 进行 身份 认证 的 ， 也 就 是 说 验证 用 户 输入 的 账号 和 密码 是 否 正确 。*/ 


@Override 
protected AuthenticationInfo doGetAuthenticationInfo 
(AuthenticationToken token) 
throws AuthenticationException { 
System. out.print1n("MyShiroRealm.doGetAuthenticationInfo()"); 
// 获 取 用 户 的 输入 账号 
String username = (String)token.getPrincipal(); 
System. out.println(token.getCredentials()); 
// 实 际 项 目 中 ， 这 里 可 以 根据 实际 情况 做 缓存 ， 如 果 不 做 ，Shiro 自己 也 是 有 时 间 间 隔 机 
制 的 ，2 分 钟 内 不 会 重复 执行 该 方法 
User user = userService.getUserById (username); 
System.out.println("----- »»userInfo-"-*user); 
if(user -- null)( 
return null; 
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SimpleAuthenticationInfo authenticationInfo = new 
SimpleAuthenticationInfo ( 
user, //HP'& 
"123456", // #0 
getName () //realm name 
); 
return authenticationInfo; 


} 
4. 登录 认证 


(1) 登录 页 面 
在 templates 目录 下 定义 了 login.html， 用 来 作为 登录 页 面 。 页 面 也 比较 简单 ， 在 表单 中 输 
入 用 户 名 、 密 码 ， 然 后 提交 表单 即 可 。 


<form action-"/login" method="post"> 
<labe1> 用 户 名 : </label><input type="text" name="id"  id-"id" ><br> 
<label > 密码 : </label><input type="text" name="pwd" id="pwd" ><br> 
<button type="submit ">#3</button><button type="reset ">HiH</button> 
</form> 


(2) 处 理 登 录 请 求 
在 LoginController 中 通过 登录 名 、 密 码 获取 到 token 实现 登录 。 


@RequestMapping (value = "/login",method = RequestMethod. POST) 
public String login(Model model,String id,String pwd) { 
// 添 加 用 户 认证 信息 
Subject subject = SecurityUtils.getSubject(); 
UsernamePasswordToken usernamePasswordToken 
UsernamePasswordToken ( 
id, 
"123456"); 


new 


try { 
subject. login (usernamePasswordToken) ; 
return "home"; 

} 

catch (UnknownAccountException e) { 
// 用 户 名 不 存在 
model.addAttribute ("msg", "用户 名 不 存在 ") ; 
return "login"; 

}catch (IncorrectCredentialsException e) ( 
// 密 码 错误 
model .addAttribute ("msg", "密码 错误 ") ; 
return "login"; 


274 


第 11 章 ”用户 权限 管理 项 目 实战 


5. Controller 层 访问 控制 
CD 首先 看 一 下 数据 库 的 数据 ， 用 户 角 色 、 角 色 权 限 的 数据 如 图 11-10、 图 11-11 所 示 。 


| Result Grid | E]. @} Fiter Rows: | Export: Egg | wrap Cell Content: I5 


| user id user name user age user sex role id role name role desp 


001 游客 11 0 001 管理 品 管理 品 
|002 Bm nu 0 00 85 ea 
[03 — ak= n 0 001 管理 品 
[002 管理 品 11 0 002 用 户 管理 。 用 户 管理 
1002 管理 品 B 0 003 资源 管理 ”资源 管理 


图 11-10 


Result Grid | EH 4} Fiter Rows: 


permission url 


000 "Em 6 EE 7. 001 管理 员 juserjal 


002 MASE 用 户 管理 6 管理 品 001 管理 局 fuser fall 
003 he see DU E 


图 11-11 


(2) 设置 权限 。 控 制 url 访问 权限 可 以 在 Controller 中 的 方法 上 面 使 用 @RequiresRoles 或 
者 @RequiresPermissions 注解 。 


@RequestMapping (value = "/edit",method = RequestMethod.GET) 
@RequiresRoles ("002") // 权 限 管理 ; 
public String editGet (Model model, @RequestParam(value="id") String id) { 
model.addAttribute("id", id); 
return "/user/edit"; 


@RequestMapping (value = "/selrole",method = RequestMethod. GET) 
GRequiresPermissions ("002") // 权 限 管理 ; 
public String selctRole (Model model, @RequestParam("id") String id, 
@RequestParam("type") Integer type) { 
model.addAttribute ("id",id); 
model.addAttribute ("type", type); 
return "/user/selrole"; 


) 


上 面 在 用 户 页 面 点 击 “ 编 辑 ” 按 钮 时 设置 需要 有 id=002 的 角色 ， 在 点 击 “ 选 择 角 色 ” 按 
钮 时 需要 有 code=002 的 权限 。 由 于 001 用 户 只 有 001 的 角色 和 001 的 权限 ， 因 此 当 使 用 用 户 
001 登录 时 ， 点 击 “ 编 辑 ”， 弹 出 框 如 图 11-12 所 示 ， 提 示 没 有 002 的 角色 ， 点 击 “ 选 择 角 色 ” 
按钮 时 ， 提 示 没 有 002 的 权限 ， 如 图 11-13 所 示 。 当 使 用 用 户 002 登录 时 ， 用 户 002 有 001、 
002. 003 三 种 角色 ， 所 以 点 击 “ 编 辑 ” 按 钮 时 显示 正常 ， 点 击 “ 选 择 角色 ”时 也 是 提示 没有 
002 的 权限 ， 因 为 权限 只 有 001。 
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用 户 信息 x 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing 
this as a fallback. 


Sat Mar 02 14:51:37 CST 2019 

There was an unexpected error (type-Internal Server Error, 
status- 500). 

Subject does not have role [002] 


图 11-12 


角色 信息 x 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a 
fallback. 


Sat Mar 02 14:50:44 CST 2019 
There was an unexpected error (type=Internal Server Error, status=500). 
Subject does not have permission [002] 


11-13 
6. 前 端 页 面 层 访问 控制 


为 了 不 像 上 面 那样 弹出 错误 页 面 , 需要 在 按钮 显示 上 设置 不 可 见 , 这样 用 户 也 不 会 点 击 到 。 
在 前 端 使 用 Shiro 需要 引入 依赖 hymeleaf-extras-shiro,， 前面 已 有 引入 。 同 时 还 需要 在 前 端 页 面 
中 设置 html 标签 引入 Shiro. 


<html xmlns:th="http://www.thymeleaf.org" 
xmlns:shiro-"http://www.pollix.at/thymeleaf/shiro"» 


为 了 测试 页 面 按钮 ， 使 用 shiro:hasAnyRoles="002,003" 判 断 用 户 角色 是 否 是 002 BK 003, 
是 就 显示 ， 不 是 则 不 显示 添加 用 户 、 批 量 删除 按钮 。 


<div class="layui-inline"> 
<a shiro:hasAnyRoles="002,003" class="layui-btn layui-btn-normal 
newsAdd btn" onclick="addUser ('') "> 添加 用 户 </a> 
</div> 
<div class-"layui-inline"» 
<a shiro:hasAnyRoles="002,003" class="layui-btn layui-btn-danger 
batchDel" onclick="getDatas () ;"> 批 量 删除 </a> 
</div> 


4001 用 户 登 录 时 ， 由 于 没有 002. 003 的 角色 ， 因 此 添加 用 户 、 批 量 删 除 按钮 都 不 显示 ， 
只 显示 查询 按钮 ， 如 图 11-14 所 示 。 
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请 输入 关键 字 查询 
s5 姓名 == 性 别 操作 
001 游客 " 
002 管理 员 11 
003 张 三 " 
图 11-14 


当 002 用 户 登 录 时 ， 由 于 有 001. 002. 003 三 种 角色 ， 因 此 添加 用 户 、 批 量 删除 按钮 都 显 
示 ， 如 图 11-15 所 示 。 


11-15 


11.3 s 


该 项 目 只 是 实现 了 Shiro 的 简单 功能 ， 其 实 Shiro 还 有 很 多 很 强大 的 功能 ， 比 如 Session 
管理 等 ， 而 且 权 限 管理 模块 还 有 很 多 需要 优化 的 功能 ， 左 侧 导航 栏 的 动态 加 载 和 权限 控制 、 
Shiro 与 Redis 结合 实现 Session 共享 、Shiro 与 Cas 结合 实现 单 点 登录 等 。 后 续 还 可 以 把 项 目 
开源 ， 集 成 更 多 模块 供 初学 者 参考 。 


277 


